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

Статья
03/02/2024

Функция lineSetAgentGroup задает группы агентов, в которые входит агент по определенному адресу.

Синтаксис

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

Параметры

hLine

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

dwAddressID

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

lpAgentGroupList

Указатель на структуру LINEAGENTGROUPLIST , идентифицируя группы, в которые должен войти текущий агент по адресу. Если указатель имеет значение NULL или число групп в указанной структуре равно нулю, агент выходит из всех групп ACD, в которые он входит в данный момент.

Поля "Name" в элементах LINEAGENTGROUPENTRY в списке игнорируются для целей этой функции; Управление группами, которые вошли в систему, основано только на значениях идентификаторов групп.

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

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

LINEERR_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTGROUP, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPASSWORD, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED.