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

Confira também

INITIALIZE_NEGOTIATION

Tspi_linenegotiatetspiversion