função TSPI_phoneGetExtensionID (tspi.h)
A função TSPI_phoneGetExtensionID recupera o identificador de extensão compatível com o provedor de serviços para o dispositivo de telefone indicado.
Sintaxe
LONG TSPIAPI TSPI_phoneGetExtensionID(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
LPPHONEEXTENSIONID lpExtensionID
);
Parâmetros
dwDeviceID
O dispositivo de telefone a ser consultado.
dwTSPIVersion
Especifica um número de versão da interface que é negociado para este dispositivo usando TSPI_phoneNegotiateTSPIVersion. 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 PHONEEXTENSIONID. 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. 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.
Retornar valor
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Comentários
Essa função normalmente é chamada pelo TAPI em resposta a um aplicativo que chama a função phoneNegotiateAPIVersion . O resultado retornado pelo provedor de serviços deve ser apropriado para uso em uma chamada subsequente para TSPI_phoneNegotiateExtVersion.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |