Función phoneNegotiateExtVersion (tapi.h)

Artículo
03/05/2024

La función phoneNegotiateExtVersion permite a una aplicación negociar una versión de extensión para usarla con el dispositivo telefónico especificado. No es necesario llamar a esta operación si la aplicación no admite extensiones.

Sintaxis

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

Parámetros

hPhoneApp

Controle el registro de la aplicación con TAPI.

dwDeviceID

Identificador del dispositivo telefónico que se va a consultar.

dwAPIVersion

Número de versión de la API que se negoció para el dispositivo telefónico especificado mediante phoneNegotiateAPIVersion.

dwExtLowVersion

Versión de extensión menos reciente del identificador de extensión devuelto por phoneNegotiateAPIVersion con la que la aplicación es compatible. La palabra de orden superior es el número de versión principal; la palabra de orden bajo es el número de versión secundaria.

dwExtHighVersion

Versión de extensión más reciente del identificador de extensión devuelto por phoneNegotiateAPIVersion con la que la aplicación es compatible. La palabra de orden superior es el número de versión principal; la palabra de orden bajo es el número de versión secundaria.

lpdwExtVersion

Puntero a un DWORD en el que se devuelve el número de versión de la extensión negociado. Si la negociación se realiza correctamente, este número está en el intervalo dwExtLowVersion para dwExtHighVersion.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

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

Comentarios

La función phoneNegotiateExtVersion se usa para negociar el número de versión de la API que se va a usar. Devuelve el identificador de extensión admitido por el dispositivo telefónico o ceros si no se proporciona ninguna extensión.

Para que la aplicación use las extensiones definidas por el identificador de extensión devuelto, debe llamar a phoneNegotiateExtVersion para negociar la versión de extensión que se va a usar.

Use phoneInitializeEx para determinar el número de dispositivos telefónicos presentes en el sistema. El identificador de dispositivo especificado por dwDeviceID varía de cero a uno menor que el número de dispositivos telefónicos presentes.

El número de versión de la extensión negociado es que en el que la aplicación y el proveedor de servicios deben funcionar. Si los intervalos de versiones no se superponen, las versiones de la aplicación y del proveedor de servicios son incompatibles y se devuelve un error.