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 |
标头 | tapi.h |
Library | Tapi32.lib |
DLL | Tapi32.dll |