Función lineNegotiateExtVersion (tapi.h)

Artículo
03/08/2023

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

Sintaxis

LONG lineNegotiateExtVersion(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  DWORD    dwExtLowVersion,
  DWORD    dwExtHighVersion,
  LPDWORD  lpdwExtVersion
);

Parámetros

hLineApp

Controle el registro de la aplicación con TAPI.

dwDeviceID

Identificador del dispositivo de línea que se va a consultar.

dwAPIVersion

Número de versión de TAPI que se negoció para el dispositivo de línea especificado mediante lineNegotiateAPIVersion.

dwExtLowVersion

Versión de extensión más antigua del identificador de extensión devuelto por lineNegotiateAPIVersion 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 lineNegotiateAPIVersion 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 una variable que contiene el número de versión de extensión que se negoció. Si la negociación se realiza correctamente, este número está en el intervalo entre dwExtLowVersion y 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:

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NODRIVER, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODEVICE, LINEERR_OPERATIONUNAVAIL.

Comentarios

Use lineInitializeEx para determinar el número de dispositivos de línea presentes en el sistema. El identificador de dispositivo especificado por dwDeviceID varía de cero a uno menor que el número de dispositivos de línea presentes.

La función lineNegotiateAPIVersion negocia el número de versión de la API que se va a usar. También recupera el identificador de extensión admitido por el dispositivo de línea, que es ceros si no se proporcionan extensiones. Los números de versión deben incrementarse en uno para cada versión. Dejar huecos en la numeración de versiones de lanzamiento puede provocar resultados inesperados.

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

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 no son compatibles y se devuelve un error.