Función lineNegotiateAPIVersion (tapi.h)

Artículo
08/26/2023

La función lineNegotiateAPIVersion permite a una aplicación negociar una versión de API que se va a usar.

Sintaxis

LONG lineNegotiateAPIVersion(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAPILowVersion,
  DWORD             dwAPIHighVersion,
  LPDWORD           lpdwAPIVersion,
  LPLINEEXTENSIONID lpExtensionID
);

Parámetros

hLineApp

Controle el registro de la aplicación con TAPI.

dwDeviceID

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

dwAPILowVersion

Versión más antigua de TAPI 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

Última versión de TAPI 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 una variable que contiene el número de versión de TAPI que se negoció. Si la negociación se realiza correctamente, este número está en el intervalo entre dwAPILowVersion y dwAPIHighVersion.

lpExtensionID

Puntero a una estructura de tipo LINEEXTENSIONID. Si el proveedor de servicios para el dwDeviceID especificado admite extensiones específicas del proveedor, después de una negociación correcta, esta estructura se rellena con el identificador de extensión de estas extensiones. 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:

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

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 se usa para negociar 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 y devuelve ceros si no se admiten extensiones. 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 API negociado es el que puede funcionar con TAPI. Si los intervalos de versiones no se superponen, las versiones de la aplicación y de la API o del proveedor de servicios son incompatibles y se devuelve un error.