funzione TSPI_lineGetExtensionID (tspi.h)
La funzione TSPI_lineGetExtensionID restituisce l'identificatore di estensione supportato dal provider di servizi per il dispositivo linea indicato.
Sintassi
LONG TSPIAPI TSPI_lineGetExtensionID(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
LPLINEEXTENSIONID lpExtensionID
);
Parametri
dwDeviceID
Dispositivo di riga da eseguire query.
dwTSPIVersion
Numero di versione dell'interfaccia già negoziato per questo dispositivo usando TSPI_lineNegotiateTSPIVersion. Questa funzione funziona in base alla specifica dell'interfaccia a questo livello di versione.
lpExtensionID
Puntatore a una struttura di tipo LINEEXTENSIONID. 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, riempie questa struttura con tutti gli zero. Pertanto, un identificatore di estensione valido non può essere costituito da tutti gli zeri.
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:
LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.
Commenti
Questa funzione viene in genere chiamata da TAPI in risposta a un'applicazione che chiama la funzione lineNegotiateAPIVersion . Il risultato restituito dal provider di servizi deve essere appropriato per l'uso in una chiamata successiva a TSPI_lineNegotiateExtVersion. Un identificatore di estensione di tutti gli zeri non è un identificatore di estensione legale, perché il valore all-zeros viene usato per indicare che il provider di servizi non supporta le estensioni.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Windows |
Intestazione | tspi.h |