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

另请参阅

补充线路服务函数

TAPI 2.2 参考概述