lineGetQueueListA 函式 (tapi.h)

lineGetQueueList 函式會傳回與特定 ACD 群組相關聯的佇列清單。 它會產生要傳送至已註冊 Proxy 函式處理程式 的LINE_PROXYREQUEST 訊息,參考類型為 LINEPROXYREQUEST_GETQUEUELIST 的 LINEPROXYREQUEST 結構。

語法

LONG lineGetQueueListA(
  HLINE           hLine,
  LPGUID          lpGroupID,
  LPLINEQUEUELIST lpQueueList
);

參數

hLine

線條裝置的句柄。

lpGroupID

GUID 的指標,識別要求佇列清單的群組。

lpQueueList

LINEQUEUELIST 類型的可變大小結構指標。 成功完成要求時,此結構會填入佇列清單。 在呼叫 lineGetQueueList之前,應用程式必須設定此結構的 dwTotalSize 成員,以指出TAPI可用來傳回資訊的記憶體數量。

注意 如果結構中的大小參數不正確,可能會覆寫數據。 如需設定結構大小的詳細資訊,請參閱 記憶體配置 主題。
 

傳回值

如果異步操作啟動時,會傳回要求標識符;否則,函式會傳回下列其中一個錯誤值:

LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED。

備註

注意

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

規格需求

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

另請參閱

關於通話中心控件

LINEPROXYREQUEST

LINEQUEUELIST

LINE_PROXYREQUEST