CIB mail technischer Leitfaden

5. Technische Schnittstellen

5.19. CibMailGetVersion

BOOL EXPORTFUNC CibMailGetVersion(unsigned long &a_lVersion)

Die Funktion liefert die aktuelle Versionsnummer der CIB mail Komponente zurück. Damit können Sie in Ihrer Applikation sicherstellen, dass eine Mindestversion vorliegt, wenn Sie etwa spezielle Programmeigenschaften benutzen, die erst ab einem bestimmten Release zur Verfügung gestellt wurden.

Parameter:

(Maßgeblich für die Parameterübergabe ist das mitgelieferte Headerfile CibMail.h.)

Typ

Variable

Bedeutung

unsigned long &

a_lVersion

a_lVersion liefert die aktuelle Versionsnummer der CIB smtp/mail Komponente zurück. Der unsigned long-Wert liefert die Information in zwei Bereichen. Die ersten zwei Bytes enthalten den Versionszähler des Hauptreleases. Die Bytes 3 und 4 enthalten den zugehörigen aktuellen Releasezähler. Je nach Programmiersprache sind die Hi- und Lowbereiche entsprechend zu beachten (siehe Codebeispiele unten).

Die Funktion liefert TRUE wenn kein Fehler aufgetreten ist. Ansonsten wird FALSE zurückgegeben.