Compartir a través de

Método ITTAPI::SetApplicationPriority (tapi3if.h)

  • Artículo

El método SetApplicationPriority permite a una aplicación establecer su prioridad en la lista de prioridades de entrega para un tipo de medio determinado o el modo de solicitud de telefonía asistida, o quitarse de la lista de prioridades.

Sintaxis

HRESULT SetApplicationPriority(
  [in] BSTR         pAppFilename,
  [in] long         lMediaType,
  [in] VARIANT_BOOL fPriority
);

Parámetros

[in] pAppFilename

Puntero a BSTR que contiene el nombre de la aplicación.

[in] lMediaType

Medio asociado a la aplicación.

[in] fPriority

Nueva prioridad para la aplicación. Si se pasa el valor VARIANT_FALSE, la aplicación se quita de la lista de prioridades del modo de solicitud o medio especificado (si aún no estaba presente, no se genera ningún error). Si se pasa el valor VARIANT_TRUE, la aplicación se inserta como la aplicación de prioridad más alta para el modo multimedia o de solicitud (y se quita de una posición de prioridad inferior, si ya estaba en la lista).

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se realizó correctamente.
E_OUTOFMEMORY
 Existe memoria insuficiente para realizar la operación.

Comentarios

La aplicación debe usar SysAllocString para asignar memoria para el parámetro pAppFilename y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.

Las prioridades establecidas con SetApplicationPriority se conservarán en los reinicios del sistema o los reinicios de tapisrv. La función ITTAPI::RegisterCallNotifications 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 ITTAPI::RegisterCallNotifications.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado tapi3if.h (include Tapi3.h)
Library Uuid.lib
Archivo DLL Tapi3.dll

Consulte también

ITBasicCallControl::HandoffIndirect

ITTAPI

Objeto TAPI