Compartilhar via


Método ITAddress2::NegotiateExtVersion (tapi3if.h)

O método NegotiateExtVersion permite que um aplicativo negocie uma versão de extensão a ser usada com o dispositivo de linha especificado. Esse método não precisará ser chamado se o aplicativo não der suporte a extensões específicas do provedor.

Sintaxe

HRESULT NegotiateExtVersion(
  [in]  long lLowVersion,
  [in]  long lHighVersion,
  [out] long *plExtVersion
);

Parâmetros

[in] lLowVersion

Versão de extensão menos recente do identificador de extensão retornado por NegotiateExtVersion com o qual o aplicativo está em conformidade. A palavra de alta ordem é o número de versão principal; a palavra de baixa ordem é o número de versão secundária.

[in] lHighVersion

Versão de extensão mais recente do identificador de extensão retornada por NegotiateExtVersion com a qual o aplicativo está em conformidade. A palavra de alta ordem é o número de versão principal; a palavra de baixa ordem é o número de versão secundária.

[out] plExtVersion

Ponteiro para um long que contém o número de versão da extensão que foi negociado. Se a negociação for bem-sucedida, esse número estará no intervalo entre lLowVersion e lHighVersion.

Retornar valor

Esse método pode retornar um desses valores.

Valor Significado
S_OK
O método foi bem-sucedido.
E_INVALIDARG
A versão inserida em lLowVersion ou lHighVersion é inválida.
E_OUTOFMEMORY
Há memória insuficiente para executar a operação.
E_POINTER
O parâmetro plExtVersion não é um ponteiro válido.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

Devicespecific

DeviceSpecificVariant

lineNegotiateExtVersion