lineSetAgentGroup 函数 (tapi.h)
lineSetAgentGroup 函数设置代理在特定地址上登录到的代理组。
语法
LONG lineSetAgentGroup(
HLINE hLine,
DWORD dwAddressID,
LPLINEAGENTGROUPLIST lpAgentGroupList
);
参数
hLine
线路设备的句柄。
dwAddressID
要更改代理信息的地址的标识符。 地址标识符与地址永久关联;标识符在操作系统升级中保持不变。
lpAgentGroupList
指向 LINEAGENTGROUPLIST 结构的指针，该结构标识当前代理将在地址上登录的组。 如果指针为 NULL 或所指示结构中的组数为零，则代理将注销它当前登录到的任何 ACD 组。
出于此函数的目的，将忽略列表中的 LINEAGENTGROUPENTRY 项中的“名称”字段;对已登录组的控件仅基于组标识符值。
返回值
如果异步操作开始，则返回正请求标识符;否则，函数将返回以下负错误值之一：
LINEERR_INVALADDRESSID、LINEERR_INVALADDRESSSTATE、LINEERR_INVALAGENTGROUP、LINEERR_INVALAGENTID、LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_INVALPASSWORD、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_UNINITIALIZED。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tapi.h |
| Library | Tapi32.lib |
| DLL | Tapi32.dll |