Метод ITTAPI::SetApplicationPriority (tapi3if.h)

Метод SetApplicationPriority позволяет приложению задать приоритет в списке приоритета передачи для определенного типа мультимедиа или режима запроса вспомогательной телефонии или удалиться из списка приоритетов.

Синтаксис

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

Параметры

[in] pAppFilename

Указатель на BSTR , содержащий имя приложения.

[in] lMediaType

Носитель, связанный с приложением.

[in] fPriority

Новый приоритет для приложения. Если передается значение VARIANT_FALSE, приложение удаляется из списка приоритетов для указанного носителя или режима запроса (если оно уже отсутствует, ошибка не создается). Если передается значение VARIANT_TRUE, приложение вставляется как приложение с наивысшим приоритетом для мультимедиа или режима запроса (и удаляется из позиции с более низким приоритетом, если оно уже было в списке).

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Метод успешно выполнен.
E_OUTOFMEMORY	Для выполнения операции недостаточно памяти.

Комментарии

Приложение должно использовать SysAllocString для выделения памяти для параметра pAppFilename и использовать SysFreeString для освобождения памяти, когда переменная больше не нужна.

Приоритеты, заданные с помощью SetApplicationPriority , будут сохраняться при перезагрузке системы или при перезапуске tapisrv. Функция ITTAPI::RegisterCallNotifications открывает строку без заданных приоритетов вызовов. По умолчанию самым приоритетным приложением будет приложение, которое сначала назвало ITTAPI::RegisterCallNotifications.

Требования

Требование	Значение
Целевая платформа	Windows
Header	tapi3if.h (включая Tapi3.h)
Библиотека	Uuid.lib
DLL	Tapi3.dll

См. также раздел

ITBasicCallControl::HandoffIndirect

ITTAPI

Объект TAPI