funzione phoneNegotiateAPIVersion (tapi.h)

Articolo
03/05/2024

Il telefonoNegotiateAPIVersion consente a un'applicazione di negoziare una versione API da usare per il dispositivo telefonico specificato.

Sintassi

LONG phoneNegotiateAPIVersion(
  HPHONEAPP          hPhoneApp,
  DWORD              dwDeviceID,
  DWORD              dwAPILowVersion,
  DWORD              dwAPIHighVersion,
  LPDWORD            lpdwAPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

Parametri

hPhoneApp

Gestire la registrazione dell'applicazione con TAPI.

dwDeviceID

Identificatore del dispositivo telefonico da eseguire query.

dwAPILowVersion

La versione dell'API meno recente con cui l'applicazione è conforme. La parola ad ordine elevato è il numero di versione principale, la parola a basso ordine è il numero di versione secondaria.

dwAPIHighVersion

La versione dell'API più recente con cui l'applicazione è conforme. La parola ad ordine elevato è il numero di versione principale, la parola a basso ordine è il numero di versione secondaria.

lpdwAPIVersion

Puntatore a una DWORD in cui verrà restituito il numero di versione dell'API negoziato. Se la negoziazione ha esito positivo, questo numero si trova nell'intervallo dwAPILowVersion per dwAPIHighVersion.

lpExtensionID

Puntatore a una struttura di tipo PHONEEXTENSIONID. Se il provider di servizi per il parametro dwDeviceID specificato supporta le estensioni specifiche del provider, questa struttura viene riempita con l'identificatore di estensione di queste estensioni al termine della negoziazione. Questa struttura contiene tutti gli zero 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 un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

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

Commenti

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

Se l'applicazione vuole usare 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 inferiore al numero di dispositivi telefonici presenti.

Il numero di versione dell'API negoziato è che in base al quale TAPI può funzionare. Se gli intervalli di versioni non si sovrappongono, le versioni dell'applicazione, dell'API o del provider di servizi non sono compatibili e viene restituito un errore.