|
<< Click to Display Table of Contents >> Navigation: MscDll Referenzhandbuch > Programmierschnittstelle > Allgemein > MSC_GetVersion |
Diese Funktion gibt die aktuelle Version der DLL zurück.
Definition
void
MSC_GetVersion(unsigned long* ApiVersion, unsigned long* DllVersion);
Parameter
ApiVersion
Gibt die API Version der DLL zurück. Die oberen 16 Bit enthalten die Hauptversion und die unteren 16 Bit die Nebenversion.
DllVersion
Gibt die Version der DLL zurück. Die oberen 16 Bit enthalten die Hauptversion und die unteren 16 Bit die Nebenversion.
Kommentare
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.