Функция lineSetAgentGroup (tapi.h)
Функция 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.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |