Funzione lineNegotiateAPIVersion (tapi.h)

Articolo
03/05/2024

La funzione lineNegotiateAPIVersion consente a un'applicazione di negoziare una versione dell'API da usare.

Sintassi

LONG lineNegotiateAPIVersion(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAPILowVersion,
  DWORD             dwAPIHighVersion,
  LPDWORD           lpdwAPIVersion,
  LPLINEEXTENSIONID lpExtensionID
);

Parametri

hLineApp

Gestire la registrazione dell'applicazione con TAPI.

dwDeviceID

Identificatore del dispositivo di riga su cui eseguire una query.

dwAPILowVersion

Versione TAPI meno recente con cui l'applicazione è conforme. La parola di ordine elevato è il numero di versione principale; la parola in ordine basso è il numero di versione secondaria.

dwAPIHighVersion

Ultima versione TAPI con cui l'applicazione è conforme. La parola di ordine elevato è il numero di versione principale; la parola in ordine basso è il numero di versione secondaria.

lpdwAPIVersion

Puntatore a una variabile contenente il numero di versione TAPI negoziato. Se la negoziazione ha esito positivo, questo numero è compreso nell'intervallo tra dwAPILowVersion e dwAPIHighVersion.

lpExtensionID

Puntatore a una struttura di tipo LINEEXTENSIONID. Se il provider di servizi per il dwDeviceID specificato supporta le estensioni specifiche del provider, in seguito a una negoziazione corretta, questa struttura viene compilata con l'identificatore di estensione di queste estensioni. Questa struttura contiene tutti gli zeri se la riga non fornisce estensioni. Un'applicazione può ignorare il parametro restituito se non usa estensioni.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

Commenti

Usare lineInitializeEx per determinare il numero di dispositivi line presenti nel sistema. L'identificatore del dispositivo specificato da dwDeviceID varia da zero a uno minore del numero di dispositivi di riga presenti.

La funzione lineNegotiateAPIVersion viene usata per negoziare il numero di versione dell'API da usare. Recupera anche l'identificatore di estensione supportato dal dispositivo della riga e restituisce zeri se non sono supportate estensioni. Se l'applicazione vuole usare le estensioni definite dall'identificatore di estensione restituito, deve chiamare lineNegotiateExtVersion per negoziare la versione dell'estensione da usare.

Il numero di versione dell'API negoziato è quello in cui è possibile operare TAPI. Se gli intervalli di versioni non si sovrappongono, le versioni dell'applicazione e dell'API o del provider di servizi non sono compatibili e viene restituito un errore.