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

Статья
08/26/2023

Функция lineGetAgentActivityList получает удостоверения действий, которые приложение может выбрать с помощью lineSetAgentActivity , чтобы указать, какую функцию фактически выполняет агент в данный момент.

Синтаксис

LONG lineGetAgentActivityListA(
  HLINE                   hLine,
  DWORD                   dwAddressID,
  LPLINEAGENTACTIVITYLIST lpAgentActivityList
);

Параметры

hLine

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

dwAddressID

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

lpAgentActivityList

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

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

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

LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALAGENTID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM LINEERR_UNINITIALIZED.

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