lineSetAgentGroup 函式 (tapi.h)

發行項
03/05/2024

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。