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

Статья
08/26/2023

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

Синтаксис

LONG lineGetAgentSessionList(
  HLINE                  hLine,
  HAGENT                 hAgent,
  LPLINEAGENTSESSIONLIST lpAgentSessionList
);

Параметры

hLine

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

hAgent

Идентификатор агента, сведения которого должны быть извлечены.

lpAgentSessionList

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

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

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

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

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