Função lineNegotiateAPIVersion (tapi.h)

Artigo
03/02/2024

A função lineNegotiateAPIVersion permite que um aplicativo negocie uma versão da API a ser usada.

Sintaxe

LONG lineNegotiateAPIVersion(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAPILowVersion,
  DWORD             dwAPIHighVersion,
  LPDWORD           lpdwAPIVersion,
  LPLINEEXTENSIONID lpExtensionID
);

Parâmetros

hLineApp

Manipule para o registro do aplicativo com TAPI.

dwDeviceID

Identificador do dispositivo de linha a ser consultado.

dwAPILowVersion

Versão mais antiga do TAPI 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.

dwAPIHighVersion

Versão mais recente do TAPI 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.

lpdwAPIVersion

Ponteiro para uma variável que contém o número de versão tapi que foi negociado. Se a negociação for bem-sucedida, esse número estará no intervalo entre dwAPILowVersion e dwAPIHighVersion.

lpExtensionID

Ponteiro para uma estrutura do tipo LINEEXTENSIONID. Se o provedor de serviços para o dwDeviceID especificado der suporte a extensões específicas do provedor, após uma negociação bem-sucedida, essa estrutura será preenchida com o identificador de extensão dessas extensões. Essa estrutura conterá todos os zeros se a linha não fornecer extensões. Um aplicativo poderá ignorar o parâmetro retornado se não usar extensões.

Retornar valor

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

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

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 é usada para negociar 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 e retorna zeros se não houver suporte para extensões. Se o aplicativo quiser usar as extensões definidas pelo identificador de extensão retornado, ele deverá chamar lineNegotiateExtVersion para negociar a versão da extensão a ser usada.

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