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

Статья
03/02/2024

Функция lineSetAgentState задает состояние агента, связанное с определенным адресом.

Синтаксис

LONG lineSetAgentState(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwAgentState,
  DWORD dwNextAgentState
);

Параметры

hLine

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

dwAddressID

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

dwAgentState

Новое состояние агента. Должен быть одной из констант LINEAGENTSTATE_ или нулем, чтобы оставить состояние агента без изменений и изменить только следующее состояние.

dwNextAgentState

Состояние агента, которое должно быть автоматически задано, когда текущий вызов по адресу становится бездействующим. Например, если известно, что работа после вызова должна выполняться, для этого поля можно задать значение LINEAGENTSTATE_WORKAFTERCALL, чтобы агенту не был назначен новый вызов после текущего вызова. Для использования следующего состояния по умолчанию, настроенного для агента, должен быть одним из LINEAGENTSTATE_ констант или нулем.

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

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

LINEERR_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTSTATE, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED.

Требования

Требование	Значение
Целевая платформа	Windows
Header	tapi.h
Библиотека	Tapi32.lib
DLL	Tapi32.dll

См. также раздел

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

Обзор справочника по TAPI 2.2

Поделиться через