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

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

Синтаксис

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

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

LINEAGENTACTIVITYLIST

дополнительных функций службы

Обзор TAPI 2.2

lineSetAgentActivity