função TSPI_lineGetExtensionID (tspi.h)

A função TSPI_lineGetExtensionID retorna o identificador de extensão ao qual o provedor de serviços dá suporte para o dispositivo de linha indicado.

Sintaxe

LONG TSPIAPI TSPI_lineGetExtensionID(
  DWORD             dwDeviceID,
  DWORD             dwTSPIVersion,
  LPLINEEXTENSIONID lpExtensionID
);

Parâmetros

dwDeviceID

O dispositivo de linha a ser consultado.

dwTSPIVersion

Um número de versão da interface que já foi negociado para este dispositivo usando TSPI_lineNegotiateTSPIVersion. Essa função opera de acordo com a especificação da interface neste nível de versão.

lpExtensionID

Um ponteiro para uma estrutura do tipo LINEEXTENSIONID. Se o provedor de serviços der suporte a extensões específicas do provedor, ele preencherá essa estrutura com o identificador de extensão dessas extensões. Se o provedor de serviços não der suporte a extensões, ele preencherá essa estrutura com todos os zeros. (Portanto, um identificador de extensão válido não pode consistir em todos os zeros.)

Retornar valor

Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:

LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.

Comentários

Essa função normalmente é chamada pelo TAPI em resposta a um aplicativo que chama a função lineNegotiateAPIVersion . O resultado retornado pelo provedor de serviços deve ser apropriado para uso em uma chamada subsequente para TSPI_lineNegotiateExtVersion. Um identificador de extensão de todos os zeros não é um identificador de extensão legal, pois o valor de todos os zeros é usado para indicar que o provedor de serviços não dá suporte a extensões.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	tspi.h

Confira também

TSPI_lineNegotiateExtVersion

Tspi_linenegotiatetspiversion