Función lineSetAppPriority (tapi.h)
La función lineSetAppPriority permite a una aplicación establecer su prioridad en la lista de prioridades de entrega para un tipo de medio determinado o modo de solicitud de telefonía asistida, o para quitarse de la lista de prioridades.
Sintaxis
LONG lineSetAppPriority(
LPCSTR lpszAppFilename,
DWORD dwMediaMode,
LPLINEEXTENSIONID lpExtensionID,
DWORD dwRequestMode,
LPCSTR lpszExtensionName,
DWORD dwPriority
);
Parámetros
lpszAppFilename
Puntero a una cadena que contiene el nombre de archivo del módulo ejecutable de la aplicación, sin los datos del directorio. En TAPI versión 2.0 o posterior, el parámetro puede especificar un nombre de archivo en formato de nombre de archivo largo o 8.3.
dwMediaMode
Tipo de medio para el que se va a establecer la prioridad de la aplicación. El valor puede ser una o varias de las constantes LINEMEDIAMODE . El valor cero se debe usar para establecer la prioridad de la aplicación para las solicitudes de telefonía asistida.
lpExtensionID
Puntero a una estructura de tipo LINEEXTENSIONID. Este parámetro se ignora.
dwRequestMode
Las condiciones de este parámetro son, si el parámetro dwMediaMode es cero, este parámetro especifica el modo de solicitud de telefonía asistida para el que se va a establecer la prioridad. Debe ser LINEREQUESTMODE_MAKECALL. Este parámetro se omite si dwMediaMode no es cero.
lpszExtensionName
Este parámetro se ignora.
dwPriority
Parámetro que indica una nueva prioridad para la aplicación. Si se pasa el valor 0, la aplicación se quita de la lista de prioridades para el medio o modo de solicitud especificados; si aún no estaba presente, no se genera ningún error. Si se pasa el valor 1, la aplicación se inserta como la aplicación de prioridad más alta para el modo multimedia o de solicitud; se quita de una posición de prioridad inferior, si ya está en la lista. Cualquier otro valor genera un error.
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_INIFILECORRUPT, LINEERR_INVALREQUESTMODE, LINEERR_INVALAPPNAME, LINEERR_NOMEM, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER.
Comentarios
Si se devuelve LINEERR_INVALMEDIAMODE , el valor especificado en dwMediaMode no es cero y no una de las constantes de LINEMEDIAMODE_.
Esta función actualiza la lista de prioridades almacenadas. Si se inicializa el sistema de telefonía, también establece las prioridades activas actuales para las aplicaciones que se ejecutan; la nueva prioridad se usa en la siguiente llamada entrante o lineHandoff en función del tipo de medio.
Las prioridades establecidas con lineSetAppPriority se conservarán en los reinicios del sistema o los reinicios de tapisrv. La función lineOpen abre la línea sin prioridades de llamada especificadas. De forma predeterminada, la aplicación de prioridad más alta será la que primero llamó lineOpen.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | tapi.h |
Library | Tapi32.lib |
Archivo DLL | Tapi32.dll |
Consulte también
Funciones de servicio de línea complementarias