lineSetAgentGroup 函式 (tapi.h)
lineSetAgentGroup 函式會設定代理程式登入特定位址的代理程式群組。
語法
LONG lineSetAgentGroup(
HLINE hLine,
DWORD dwAddressID,
LPLINEAGENTGROUPLIST lpAgentGroupList
);
參數
hLine
線條裝置的句柄。
dwAddressID
要變更代理程式資訊的位址識別碼。 位址標識符永久與地址相關聯;標識碼在操作系統升級之間維持不變。
lpAgentGroupList
LINEAGENTGROUPLIST 結構的指標，識別目前代理程式要登入位址的群組。 如果指標為 NULL 或指示結構中的群組數位數目為零，則代理程式會登入的任何 ACD 群組。
針對此函式的目的，會忽略清單中 LINEAGENTGROUPENTRY 專案中的 「Name」 字段;登入群組的控件僅以群組標識碼值為基礎。
傳回值
如果異步操作啟動，則傳回正要求標識符;否則，函式會傳回下列其中一個負誤差值：
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 |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |