Función lineSetAppPriorityA (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 lineSetAppPriorityA(
  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 debe usarse 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 omite.

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 es distinto de cero.

lpszExtensionName

Este parámetro se omite.

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 del 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.

Observaciones

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 persistirá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ó a lineOpen.

Nota

El encabezado tapi.h define lineSetAppPriority como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	tapi.h
biblioteca de	Tapi32.lib
DLL de	Tapi32.dll

Consulte también

LINEEXTENSIONID

funciones de servicio de línea complementarias

de información general de referencia de TAPI 2.2

lineHandoff