Funzione phoneNegotiateExtVersion (tapi.h)

Articolo
08/26/2023

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

Sintassi

LONG phoneNegotiateExtVersion(
  HPHONEAPP hPhoneApp,
  DWORD     dwDeviceID,
  DWORD     dwAPIVersion,
  DWORD     dwExtLowVersion,
  DWORD     dwExtHighVersion,
  LPDWORD   lpdwExtVersion
);

Parametri

hPhoneApp

Gestire la registrazione dell'applicazione con TAPI.

dwDeviceID

Identificatore del dispositivo telefonico su cui eseguire una query.

dwAPIVersion

Numero di versione dell'API negoziato per il dispositivo telefonico specificato usando phoneNegotiateAPIVersion.

dwExtLowVersion

Versione dell'estensione meno recente dell'identificatore di estensione restituito da phoneNegotiateAPIVersion 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 restituita da phoneNegotiateAPIVersion 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 DWORD in cui viene restituito il numero di versione dell'estensione negoziato. Se la negoziazione ha esito positivo, questo numero è compreso nell'intervallo dwExtLowVersion a dwExtHighVersion.

Valore restituito

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

PHONEERR_INVALAPPHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NODRIVER, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_UNINITIALIZED, PHONEERR_INVALPOINTER PHONEERR_NODEVICE.

Commenti

La funzione phoneNegotiateExtVersion viene usata per negoziare il numero di versione dell'API da usare. Restituisce l'identificatore di estensione supportato dal dispositivo telefonico o zeri se non vengono fornite estensioni.

Affinché l'applicazione usi le estensioni definite dall'identificatore di estensione restituito, deve chiamare phoneNegotiateExtVersion per negoziare la versione dell'estensione da usare.

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

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.