|
<< Click to Display Table of Contents >> Navigation: MscDll Referenzhandbuch > HighLevel-Funktionen (Optional) > IRHL_GetVersionHL |
Diese Funktion gibt die aktuelle Version der HighLevel-DLL zurück.
Definition
MSC_STATUS
IRHL_GetVersionHL(unsigned long* pulApi_Major, unsigned long* pulApi_Minor, unsigned long* pulDLL_Major, unsigned long* pulDLL_Minor);
Parameter
pulApi_Major
Gibt den Major-Teil der API Version der HighLevel-DLL zurück.
pulApi_Minor
Gibt den Minor-Teil der API Version der HighLevel-DLL zurück.
pulDLL_Major
Gibt den Major-Teil der Version der HighLevel-DLL zurück.
pulDLL_Minor
Gibt den Minor-Teil der Version der HighLevel-DLL zurück.
Rückgabewert
Die Funktion gibt immer MSC_STATUS_SUCCESS zurück.
Kommentare
Die API-Version wird nur bei Änderungen an der Programmierschnittstelle erhöht.
Die DLL-Version wird bei jeder Änderung der DLL erhöht.
Für die API-Version gilt:
Wenn Veränderungen an der Programmierschnittstelle vorgenommen werden, die kompatibel mit älteren Versionen sind, wird die niedrigere Versionsnummer erhöht.
Bei Änderungen, die eine Inkompatibilität mit älteren Versionen verursachen, wird die höhere Versionsnummer erhöht.
Anwendungen sollten den Rückgabewert dieser Funktion in Abhängigkeit einer in der Applikation hinterlegten Konstante überprüfen, um sicherzustellen, dass die DLL die erwartete API Version unterstützt. Die Nummer der Hauptversion muss der erwarteten Nummer exakt entsprechen. Die Nummer der Nebenversion muss größer oder gleich groß sein wie die erwartete Nummer.
Der Aufruf dieser Funktion ist auch bei inaktiver Kommunikation möglich.