Condividi tramite


Funzione lineNegotiateAPIVersion (tapi.h)

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.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione tapi.h
Libreria Tapi32.lib
DLL Tapi32.dll

Vedi anche

Informazioni di riferimento sui servizi di telefonia di base

LINEEXTENSIONID

Panoramica dei riferimenti a TAPI 2.2

Controllo delle versioni TAPI

lineInitializeEx

lineNegotiateExtVersion