Função lineNegotiateExtVersion (tapi.h)

Artigo
08/26/2023

A função lineNegotiateExtVersion permite que um aplicativo negocie uma versão de extensão a ser usada com o dispositivo de linha especificado. Essa operação não precisará ser chamada se o aplicativo não der suporte a extensões.

Sintaxe

LONG lineNegotiateExtVersion(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  DWORD    dwExtLowVersion,
  DWORD    dwExtHighVersion,
  LPDWORD  lpdwExtVersion
);

Parâmetros

hLineApp

Manipule para o registro do aplicativo com TAPI.

dwDeviceID

Identificador do dispositivo de linha a ser consultado.

dwAPIVersion

Número de versão tapi que foi negociado para o dispositivo de linha especificado usando lineNegotiateAPIVersion.

dwExtLowVersion

Versão de extensão mais antiga do identificador de extensão retornada por lineNegotiateAPIVersion 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.

dwExtHighVersion

Versão de extensão mais recente do identificador de extensão retornada por lineNegotiateAPIVersion 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.

lpdwExtVersion

Ponteiro para uma variável 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 dwExtLowVersion e dwExtHighVersion.

Retornar valor

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NODRIVER, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODEVICE, LINEERR_OPERATIONUNAVAIL.

Comentários

Use lineInitializeEx para determinar o número de dispositivos de linha presentes no sistema. O identificador de dispositivo especificado por dwDeviceID varia de zero a um menor que o número de dispositivos de linha presentes.

A função lineNegotiateAPIVersion negocia o número de versão da API a ser usado. Ele também recupera o identificador de extensão compatível com o dispositivo de linha, que é zeros se nenhuma extensão for fornecida. Os números de versão devem ser incrementados em um para cada versão. Deixar lacunas na numeração da versão de versão pode causar resultados inesperados.

Se o aplicativo quiser usar as extensões definidas pelo identificador de extensão retornado, ele deverá chamar lineNegotiateExtVersion para negociar a versão de extensão a ser usada.

O número de versão da extensão negociado é aquele sob o qual o aplicativo e o provedor de serviços devem operar. Se os intervalos de versão não se sobrepõem, as versões do aplicativo e do provedor de serviços serão incompatíveis e um erro será retornado.