Función phoneNegotiateAPIVersion (tapi.h)

Artículo
03/02/2024

PhoneNegotiateAPIVersion permite que una aplicación negocie una versión de API para usarla para el dispositivo telefónico especificado.

Sintaxis

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

Parámetros

hPhoneApp

Controle el registro de la aplicación con TAPI.

dwDeviceID

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

dwAPILowVersion

Versión de API menos reciente 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.

dwAPIHighVersion

Versión más reciente de la API 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.

lpdwAPIVersion

Puntero a un DWORD en el que se devolverá el número de versión de la API que se negoció. Si la negociación se realiza correctamente, este número está en el intervalo dwAPILowVersion a dwAPIHighVersion.

lpExtensionID

Puntero a una estructura de tipo PHONEEXTENSIONID. Si el proveedor de servicios del parámetro dwDeviceID especificado admite extensiones específicas del proveedor, esta estructura se rellena con el identificador de extensión de estas extensiones cuando la negociación se realiza correctamente. Esta estructura contiene todos los ceros si la línea no proporciona extensiones. Una aplicación puede omitir el parámetro devuelto si no usa extensiones.

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_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Comentarios

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

Si la aplicación quiere usar 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 API negociado es que bajo el cual TAPI puede funcionar. Si los intervalos de versiones no se superponen, la aplicación, la API o las versiones del proveedor de servicios son incompatibles y se devuelve un error.