Функция lineSetAgentStateEx (tapi.h)
Функция lineSetAgentStateEx задает состояние агента, связанное с определенным дескриптором агента. Он создает LINE_PROXYREQUEST сообщение, которое будет отправлено зарегистрированным обработчику прокси-функции, ссылаясь на структуру LINEPROXYREQUEST типа LINEPROXYREQUEST_SETAGENTSTATEEX.
Синтаксис
LONG lineSetAgentStateEx(
HLINE hLine,
HAGENT hAgent,
DWORD dwAgentState,
DWORD dwNextAgentState
);
Параметры
hLine
Дескриптор для устройства линии.
hAgent
Идентификатор агента, сведения которого необходимо изменить.
dwAgentState
Новое состояние агента. Должен быть одной из констант LINEAGENTSTATEEX_ или нулем, чтобы оставить состояние агента без изменений и изменить только следующее состояние.
dwNextAgentState
Следующее состояние агента. Должен быть одной из LINEAGENTSTATEEX_ констант или нулем.
Возвращаемое значение
Возвращает идентификатор запроса, если начинается асинхронная операция; В противном случае функция возвращает одно из следующих значений ошибки:
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 |