Função phoneNegotiateAPIVersion (tapi.h)

Artigo
03/05/2024

O phoneNegotiateAPIVersion permite que um aplicativo negocie uma versão da API a ser usada para o dispositivo de telefone especificado.

Sintaxe

LONG phoneNegotiateAPIVersion(
  HPHONEAPP          hPhoneApp,
  DWORD              dwDeviceID,
  DWORD              dwAPILowVersion,
  DWORD              dwAPIHighVersion,
  LPDWORD            lpdwAPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

Parâmetros

hPhoneApp

Manipule para o registro do aplicativo com TAPI.

dwDeviceID

Identificador do dispositivo de telefone a ser consultado.

dwAPILowVersion

Versão menos recente da API com a qual o aplicativo está em conformidade. A palavra de alta ordem é o número de versão principal, a palavra de ordem baixa é o número de versão secundária.

dwAPIHighVersion

Versão mais recente da API com a qual o aplicativo está em conformidade. A palavra de alta ordem é o número de versão principal, a palavra de ordem baixa é o número de versão secundária.

lpdwAPIVersion

Ponteiro para um DWORD no qual o número de versão da API que foi negociado será retornado. Se a negociação for bem-sucedida, esse número estará no intervalo dwAPILowVersion para dwAPIHighVersion.

lpExtensionID

Ponteiro para uma estrutura do tipo PHONEEXTENSIONID. Se o provedor de serviços para o parâmetro dwDeviceID especificado der suporte a extensões específicas do provedor, essa estrutura será preenchida com o identificador de extensão dessas extensões quando a negociação for bem-sucedida. Essa estrutura conterá todos os zeros se a linha não fornecer extensões. Um aplicativo poderá ignorar o parâmetro retornado se ele 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 possíveis valores retornados são:

PHONEERR_INVALAPPHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NODRIVER, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Comentários

A função phoneNegotiateAPIVersion é usada para negociar o número de versão da API a ser usado com o dispositivo de telefone especificado. Ele retornará o identificador de extensão compatível com o dispositivo de telefone ou zeros se nenhuma extensão for fornecida.

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

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

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, da API ou do provedor de serviços são incompatíveis e um erro é retornado.