Функция lineSetAppPriority (tapi.h)

Статья
03/02/2024

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

Синтаксис

LONG lineSetAppPriority(
  LPCSTR            lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPCSTR            lpszExtensionName,
  DWORD             dwPriority
);

Параметры

lpszAppFilename

Указатель на строку, содержащую имя файла исполняемого модуля приложения без данных каталога. В TAPI версии 2.0 или более поздней параметр может указывать имя файла в формате long или 8.3.

dwMediaMode

Тип носителя, для которого должен быть задан приоритет приложения. Значением может быть одна или несколько констант LINEMEDIAMODE . Для задания приоритета приложения для запросов вспомогательной телефонии следует использовать нулевое значение.

lpExtensionID

Указатель на структуру типа LINEEXTENSIONID. Этот параметр не учитывается.

dwRequestMode

Условия для этого параметра: если параметр dwMediaMode равен нулю, этот параметр указывает режим запроса вспомогательной телефонии, для которого необходимо задать приоритет. Это должно быть LINEREQUESTMODE_MAKECALL. Этот параметр игнорируется, если параметр dwMediaMode не является нулевым.

lpszExtensionName

Этот параметр не учитывается.

dwPriority

Параметр , указывающий новый приоритет для приложения. Если передается значение 0, приложение удаляется из списка приоритетов для указанного носителя или режима запроса; Если он еще не присутствовал, ошибка не возникает. Если передается значение 1, приложение вставляется как приложение с наивысшим приоритетом для носителя или режима запроса; Он удаляется из позиции с более низким приоритетом, если он уже в списке. Любое другое значение приводит к ошибке.

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

Возвращает ноль, если запрос выполнен успешно, или отрицательный номер ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_INIFILECORRUPT, LINEERR_INVALREQUESTMODE, LINEERR_INVALAPPNAME, LINEERR_NOMEM, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAILLINEERR_INVALPOINTER.

Эта функция обновляет сохраненный список приоритетов. Если система телефонии инициализирована, она также устанавливает текущие активные приоритеты для приложений, которые затем выполняются; новый приоритет используется при следующем входящем вызове или lineHandoff в зависимости от типа носителя.

Приоритеты, заданные с помощью lineSetAppPriority , будут сохраняться при перезапусках системы или при перезапусках tapisrv. Функция lineOpen открывает строку без заданных приоритетов вызовов. По умолчанию приложение с наивысшим приоритетом будет первым вызвать lineOpen.