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

Vedi anche

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion