função TSPI_phoneNegotiateExtVersion (tspi.h)
A função TSPI_phoneNegotiateExtVersion retorna o número de versão de extensão mais alto em que o provedor de serviços pode operar para esse dispositivo, considerando o intervalo de versões de extensão possíveis.
Sintaxe
LONG TSPIAPI TSPI_phoneNegotiateExtVersion(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwExtVersion
);
Parâmetros
dwDeviceID
Identifica o dispositivo de telefone para o qual a negociação de versão da interface deve ser executada.
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.
dwLowVersion
O número de versão de extensão mais baixo sob o qual o TAPI ou seu aplicativo cliente podem operar. O WORD mais significativo é o número de versão principal e o WORD menos significativo é o número de versão secundária.
dwHighVersion
O número de versão de extensão mais alto sob o qual o TAPI ou seu aplicativo cliente pode operar. O WORD mais significativo é o número de versão principal e o WORD menos significativo é o número de versão secundária.
lpdwExtVersion
Um ponteiro para um DWORD. Após um retorno bem-sucedido dessa função, o provedor de serviços preenche esse local com o número de versão de extensão mais alto, dentro do intervalo solicitado pelo chamador, no qual o provedor de serviços pode operar. O WORD mais significativo é o número de versão principal e o WORD menos significativo é o número de versão secundária. Se o intervalo solicitado não sobrepor o intervalo com suporte pelo provedor de serviços, a função retornará PHONEERR_INCOMPATIBLEEXTVERSION.
Valor retornado
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:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Comentários
Essa função pode ser chamada antes ou depois que o dispositivo tiver sido aberto pelo TAPI. Se o dispositivo estiver aberto no momento e tiver uma versão de extensão selecionada, a função deverá retornar esse número de versão se ele estiver dentro do intervalo solicitado. Se o número de versão selecionado estiver fora do intervalo solicitado, a função retornará PHONEERR_INCOMPATIBLEEXTVERSION.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |