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

Статья
03/05/2024

Функция lineGetAgentGroupList получает удостоверения групп агентов (сочетание очереди, руководителя, уровня навыков и т. д.), в которые агенту, вошедшего в систему на рабочей станции, разрешено выполнять вход на распространитетеле автоматических вызовов.

Синтаксис

LONG lineGetAgentGroupListA(
  HLINE                hLine,
  DWORD                dwAddressID,
  LPLINEAGENTGROUPLIST lpAgentGroupList
);

Параметры

hLine

Дескриптор на устройстве с открытой линией.

dwAddressID

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

lpAgentGroupList

Указатель на структуру изменчивого размера типа LINEAGENTGROUPLIST. После успешного выполнения запроса эта структура заполняется списком групп агентов, в которые агент может войти в данный момент (которые должны включать все группы, в которых агент уже вошел, если таковые имеются).

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

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

LINEERR_INVALADDRESSID, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL LINEERR_UNINITIALIZED.

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