funzione TSPI_phoneGetExtensionID (tspi.h)

Articolo
03/03/2024

La funzione TSPI_phoneGetExtensionID recupera l'identificatore di estensione supportato dal provider di servizi per il dispositivo telefonico indicato.

Sintassi

LONG TSPIAPI TSPI_phoneGetExtensionID(
  DWORD              dwDeviceID,
  DWORD              dwTSPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

Parametri

dwDeviceID

Dispositivo telefonico su cui eseguire una query.

dwTSPIVersion

Specifica un numero di versione dell'interfaccia negoziato per questo dispositivo tramite TSPI_phoneNegotiateTSPIVersion. Questa funzione opera in base alla specifica dell'interfaccia a questo livello di versione.

lpExtensionID

Puntatore a una struttura di tipo PHONEEXTENSIONID. Se il provider di servizi supporta estensioni specifiche del provider, questa struttura viene riempita con l'identificatore di estensione di queste estensioni. Se il provider di servizi non supporta le estensioni, questa struttura viene riempita con tutti gli zeri. Un identificatore di estensione di tutti gli zeri non è un identificatore di estensione legale, poiché il valore all-zeros viene usato per indicare che il provider di servizi non supporta le estensioni.

Valore restituito

Restituisce zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.

Commenti

Questa funzione viene in genere chiamata da TAPI in risposta a un'applicazione che chiama la funzione phoneNegotiateAPIVersion . Il risultato restituito dal provider di servizi deve essere appropriato per l'uso in una chiamata successiva a TSPI_phoneNegotiateExtVersion.