Compartilhar via


Função phoneNegotiateExtVersion (tapi.h)

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.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi.h
Biblioteca Tapi32.lib
DLL Tapi32.dll

Confira também

Referência de Serviços de Telefonia Estendida

Visão geral da referência do TAPI 2.2

Phoneinitializeex

Phonenegotiateapiversion