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 |