функция lineGetGroupListA (tapi.h)

Статья
11/20/2024

Функция lineGetGroupList возвращает список групп ACD, доступных в системе ACD. Он создает сообщение LINE_PROXYREQUEST для отправки в зарегистрированный обработчик функции прокси-сервера, ссылаясь на структуру LINEPROXYREQUEST типа LINEPROXYREQUEST_GETGROUPLIST.

Синтаксис

LONG lineGetGroupListA(
  HLINE                hLine,
  LPLINEAGENTGROUPLIST lpGroupList
);

Параметры

hLine

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

lpGroupList

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

Примечание Если параметры размера в структуре неверны, существует вероятность того, что данные могут быть перезаписаны. Дополнительные сведения о настройке размеров структуры см. в разделе выделение памяти.

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

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

LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Замечания

Заметка

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