Функция lineSetAgentState (tapi.h)
Функция 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 |