função TSPI_lineNegotiateExtVersion (tspi.h)
A função TSPI_lineNegotiateExtVersion 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_lineNegotiateExtVersion(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwExtVersion
);
Parâmetros
dwDeviceID
Identifica o dispositivo de linha para o qual a negociação de versão da interface deve ser executada. O valor INITIALIZE_NEGOTIATION pode não ser usado para essa função.
dwTSPIVersion
Um número de versão de 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.
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. O TAPI não valida esse parâmetro quando essa função é chamada.
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. O TAPI não valida esse parâmetro quando essa função é chamada.
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 compatível com o provedor de serviços, a função retornará LINEERR_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:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.
Comentários
Essa função pode ser chamada antes ou depois que o dispositivo é aberto pelo TAPI. Se o dispositivo estiver aberto no momento e tiver uma versão de extensão selecionada, a função fornecerá 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á LINEERR_INCOMPATIBLEEXTVERSION.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |