функция lineSetAppPriorityA (tapi.h)

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

Синтаксис

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

Параметры

lpszAppFilename

Указатель на строку, содержащую имя файла исполняемого модуля приложения без данных каталога. В TAPI версии 2.0 или более поздней параметр может указать имя файла в формате длинного или 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_RESOURCEUNAVAIL, LINEERR_INVALPOINTER.

Замечания

Если возвращается LINEERR_INVALMEDIAMODE, то значение, указанное в dwMediaMode, не равно нулю, а не одному из LINEMEDIAMODE_ констант.

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

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

Заметка

Заголовок tapi.h определяет lineSetAppPriority как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

LINEEXTENSIONID

дополнительных функций службы

Обзор TAPI 2.2

lineHandoff