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

Статья
11/20/2024

Функция lineGetAgentCaps получает возможности, связанные с агентом, поддерживаемые на указанном устройстве строки. Если определенный агент называется, возможности включают в себя список групп ACD, в которых агент может войти.

Синтаксис

LONG lineGetAgentCapsA(
  HLINEAPP        hLineApp,
  DWORD           dwDeviceID,
  DWORD           dwAddressID,
  DWORD           dwAppAPIVersion,
  LPLINEAGENTCAPS lpAgentCaps
);

Параметры

hLineApp

Обработка регистрации приложения с помощью TAPI.

dwDeviceID

Устройство строки, содержащее адрес для запроса.

dwAddressID

Адрес на заданном устройстве строки, возможности которого необходимо запрашивать. Идентификатор адреса постоянно связан с адресом; Идентификатор остается постоянным в обновлениях операционной системы.

dwAppAPIVersion

Самая высокая версия API, поддерживаемая приложением. Это значение не должно быть согласовано с помощью lineNegotiateAPIVersion на устройстве, запрашиваемом.

lpAgentCaps

Указатель на изменяемую структуру типа LINEAGENTCAPS. После успешного завершения запроса эта структура заполняется сведениями о возможностях агента. Перед вызовом lineGetAgentCapsприложение должно задать dwTotalSize элемент этой структуры, чтобы указать объем памяти, доступной TAPI для возврата сведений.

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

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

LINEERR_BADDEVICEID, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALADDRESSID, LINEERR_INVALAPPHANDLE, LINEERR_INVALPOINTER, LINEERR_NODEVICE, LINEERR_NODRIVER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Замечания

Заметка

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

Требования

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

См. также

LINEAGENTCAPS

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

Обзор TAPI 2.2

lineNegotiateAPIVersion

Поделиться через