lineGetGroupListA 函式 (tapi.h)
lineGetGroupList函式會傳回 ACD 系統上可用的 ACD 群組清單。 它會產生要傳送至已註冊 Proxy 函式處理常式的LINE_PROXYREQUEST訊息，參考類型為 LINEPROXYREQUEST_GETGROUPLIST的 LINEPROXYREQUEST結構。
語法
LONG lineGetGroupListA(
HLINE hLine,
LPLINEAGENTGROUPLIST lpGroupList
);
參數
hLine
線條裝置的控制碼。
lpGroupList
LINEAGENTGROUPLIST類型的可變大小結構的指標。 成功完成要求時，此結構會填入可用的 ACD 群組清單。 在呼叫 lineGetGroupList 函式之前，應用程式必須設定這個結構的 dwTotalSize 成員，以指出 TAPI 可用來傳回信息的記憶體數量。
注意 如果結構中的大小參數不正確，可能會覆寫資料。 如需設定結構大小的詳細資訊，請參閱 記憶體配置 主題。
傳回值
如果非同步作業啟動時，傳回要求識別碼;否則，函式會傳回下列其中一個錯誤值：
LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_UNINITIALIZED。
備註
注意
tapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 lineGetGroupList 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |