função TSPI_lineNegotiateTSPIVersion (tspi.h)
A função TSPI_lineNegotiateTSPIVersion retorna a versão spi mais alta em que o provedor de serviços pode operar para este dispositivo, considerando o intervalo de versões de SPI possíveis.
Sintaxe
LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
DWORD dwDeviceID,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwTSPIVersion
);
Parâmetros
dwDeviceID
Identifica o dispositivo de linha para o qual a negociação de versão da interface deve ser executada. Além dos identificadores de dispositivo dentro do intervalo ao qual o provedor de serviços dá suporte, esse pode ser o valor:
INITIALIZE_NEGOTIATION
Esse valor é usado para significar que uma versão geral da interface deve ser negociada.
dwLowVersion
O menor número de versão do TSPI no qual o TAPI 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.
dwHighVersion
O número de versão mais alto do TSPI no qual o TAPI 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.
lpdwTSPIVersion
Um ponteiro para um DWORD. O provedor de serviços preenche esse local com o número de versão de TSPI 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á LINEERR_INCOMPATIBLEAPIVERSION.
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_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Comentários
Quando dwDeviceID é INITIALIZE_NEGOTIATION, essa função não deve retornar LINEERR_OPERATIONUNAVAIL, pois essa função (com esse valor) é obrigatória para negociar a versão geral da interface, mesmo que o provedor de serviços não dê suporte a nenhum dispositivo de linha.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |