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

Статья
08/26/2023

Функция 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.