dsmQueryApiVersion

La chiamata alla funzione dsmQueryApiVersion esegue una richiesta di query per la versione della libreria API a cui accede il client delle applicazioni.

Tutti gli aggiornamenti all'API vengono eseguiti in un formato compatibile verso l'alto. Qualsiasi client delle applicazioni con una release o una versione API inferiore o uguale alla libreria API sulla workstation dell'utente finale funziona senza modifiche. Prima di procedere, tenere presente che se la chiamata dsmQueryApiVersion restituisce una versione o una release della versione precedente a quella dei client delle applicazioni, alcune chiamate API potrebbero essere migliorate in un modo non supportato dalla versione precedente dell'API dell'utente finale.

Il numero di versione dell'applicazione API è memorizzato nel file di intestazione dsmapitd.h come costanti DSM_API_VERSION, DSM_API_RELEASE e DSM_API_LEVEL.

Non ci sono codici di ritorno specifici per questa chiamata.

Sintassi

void dsmQueryApiVersion  (dsmApiVersion *apiVersionP);

Parametri

*apiVersionPdsmApiVersion (O)
Questo parametro è un puntatore alla struttura che contiene i componenti versione, release e livello della libreria API. Ad esempio, se la versione della libreria è 1.1.0, dopo essere ritornati dalla chiamata, i campi della struttura contengono i seguenti valori:
   dsmApiVersionP->version  = 1
   dsmApiVersionP->release  = 1
   dsmApiVersionP->level    = 0