Función lineSetAppPriority (tapi.h)

Artículo
08/26/2023

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.