Función lineNegotiateExtVersion (tapi.h)
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.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | tapi.h |
Library | Tapi32.lib |
Archivo DLL | Tapi32.dll |
Consulte también
Referencia de servicios de telefonía extendida