Funzione lineNegotiateExtVersion (tapi.h)

Articolo
03/08/2023

La funzione lineNegotiateExtVersion consente a un'applicazione di negoziare una versione dell'estensione da usare con il dispositivo line specificato. Questa operazione non deve essere chiamata se l'applicazione non supporta le estensioni.

Sintassi

LONG lineNegotiateExtVersion(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  DWORD    dwExtLowVersion,
  DWORD    dwExtHighVersion,
  LPDWORD  lpdwExtVersion
);

Parametri

hLineApp

Gestire la registrazione dell'applicazione con TAPI.

dwDeviceID

Identificatore del dispositivo di riga su cui eseguire una query.

dwAPIVersion

Numero di versione TAPI negoziato per il dispositivo line specificato usando lineNegotiateAPIVersion.

dwExtLowVersion

Versione dell'estensione meno recente dell'identificatore di estensione restituito da lineNegotiateAPIVersion 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.

dwExtHighVersion

Versione più recente dell'estensione dell'identificatore di estensione restituito da lineNegotiateAPIVersion 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.

lpdwExtVersion

Puntatore a una variabile che contiene il numero di versione dell'estensione negoziato. Se la negoziazione ha esito positivo, questo numero è compreso nell'intervallo tra dwExtLowVersion e dwExtHighVersion.

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_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NODRIVER, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODEVICE LINEERR_OPERATIONUNAVAIL.

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 negozia il numero di versione dell'API da usare. Recupera anche l'identificatore di estensione supportato dal dispositivo della riga, ovvero zero se non vengono fornite estensioni. I numeri di versione devono essere incrementati di uno per ogni versione. Lasciare lacune nella numerazione delle versioni di rilascio può causare risultati imprevisti.

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'estensione negoziato è quello in cui l'applicazione e il provider di servizi devono operare entrambi. Se gli intervalli di versioni non si sovrappongono, le versioni dell'applicazione e del provider di servizi non sono compatibili e viene restituito un errore.