funzione TSPI_phoneGetExtensionID (tspi.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |