共用方式為

lineGetAgentGroupListA 函式 (tapi.h)

  • 發行項

lineGetAgentGroupList 函式會取得代理程式群組的身分識別， (佇列、監督員、技能等級等組合，) 允許在工作站上登入的代理程式登入自動呼叫散發者。

語法

LONG lineGetAgentGroupListA(
  HLINE                hLine,
  DWORD                dwAddressID,
  LPLINEAGENTGROUPLIST lpAgentGroupList
);

參數

hLine

開啟行裝置的句柄。

dwAddressID

要查詢其代理程式狀態的開啟行裝置上的位址。

lpAgentGroupList

LINEAGENTGROUPLIST 類型的可變大小結構指標。 成功完成要求時，如果有任何) ，此結構會填入代理程序此時可登入的代理程式群組清單， (應該包含代理程式已登入的任何群組。

傳回值

如果異步操作啟動時，會傳回正要求標識符;否則，此函式會傳回下列其中一個負誤差值：

LINEERR_INVALADDRESSID、LINEERR_INVALAGENTID、LINEERR_INVALLINEHANDLE、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL LINEERR_UNINITIALIZED。

備註

注意

tapi.h 標頭會將 lineGetAgentGroupList 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

LINEAGENTGROUPLIST

增補行服務函式

TAPI 2.2 參考概觀