dsmQueryApiVersion
Der Funktionsaufruf dsmQueryApiVersion führt eine Abfrageanforderung für die API-Bibliotheksversion aus, auf die der Anwendungsclient zugreift.
Alle Aktualisierungen an der API erfolgen in aufwärtskompatiblem Format. Jeder Anwendungsclient mit einer API-Version oder einem API-Release kleiner-gleich der Version bzw. des Release der API-Bibliothek auf der Workstation des Endbenutzers wird ohne Änderung ausgeführt. Beachten Sie, dass einige API-Aufrufe möglicherweise auf eine Weise erweitert werden, die von der älteren Version der API des Endbenutzers nicht unterstützt wird, bevor Sie fortfahren, wenn der dsmQueryApiVersion -Aufruf eine ältere Version oder ein älteres Versionsrelease als die der Anwendungsclients zurückgibt.
Die Versionsnummer der Anwendungs-API wird in der Headerdatei dsmapitd.h als die Konstanten DSM_API_VERSION, DSM_API_RELEASE und DSM_API_LEVEL gespeichert.
Es gibt keine spezifischen Rückkehrcodes für diesen Aufruf.
Syntax
void dsmQueryApiVersion (dsmApiVersion *apiVersionP);Parameter
- dsmApiVersion *apiVersionP (O)
- Dieser Parameter ist ein Verweis auf die Struktur, die die Version, das
Release und die Stufe der API-Bibliothek enthält. Wenn die Bibliothek
beispielsweise die Version 1.1.0 hat, enthalten die Felder der Struktur nach
der Rückkehr des Aufrufs die folgenden Werte:
dsmApiVersionP->version = 1 dsmApiVersionP->release = 1 dsmApiVersionP->level = 0