lineSetAgentStateEx 函数 (tapi.h)
lineSetAgentStateEx 函数设置与特定代理句柄关联的代理状态。 它生成一条要发送到已注册代理函数处理程序 的LINE_PROXYREQUEST 消息,引用类型为 LINEPROXYREQUEST_SETAGENTSTATEEX 的 LINEPROXYREQUEST 结构。
语法
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 |
标头 | tapi.h |
Library | Tapi32.lib |
DLL | Tapi32.dll |