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

Статья
08/26/2023

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