Função phoneNegotiateExtVersion (tapi.h)

Artigo
08/26/2023

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

Sintaxe

LONG phoneNegotiateExtVersion(
  HPHONEAPP hPhoneApp,
  DWORD     dwDeviceID,
  DWORD     dwAPIVersion,
  DWORD     dwExtLowVersion,
  DWORD     dwExtHighVersion,
  LPDWORD   lpdwExtVersion
);

Parâmetros

hPhoneApp

Manipule para o registro do aplicativo com TAPI.

dwDeviceID

Identificador do dispositivo de telefone a ser consultado.

dwAPIVersion

Número de versão da API que foi negociado para o dispositivo de telefone especificado usando phoneNegotiateAPIVersion.

dwExtLowVersion

Versão de extensão menos recente do identificador de extensão retornado por phoneNegotiateAPIVersion 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 retornado por phoneNegotiateAPIVersion 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.

lpdwExtVersion

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

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:

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

Comentários

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

Para que o aplicativo use as extensões definidas pelo identificador de extensão retornado, ele deve chamar phoneNegotiateExtVersion para negociar a versão da 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 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.