lineGetAgentSessionInfo 函式 (tapi.h)

發行項
03/02/2024

lineGetAgentSessionInfo 函式會傳回結構，該結構會保存與特定代理程式會話句柄相關聯的 ACD 資訊。它會產生要傳送至已註冊 Proxy 函式處理程式的LINE_PROXYREQUEST 訊息，參考類型為 LINEPROXYREQUEST_GETAGENTSESSIONINFO 的 LINEPROXYREQUEST 結構。

語法

LONG lineGetAgentSessionInfo(
  HLINE                  hLine,
  HAGENTSESSION          hAgentSession,
  LPLINEAGENTSESSIONINFO lpAgentSessionInfo
);

參數

hLine

線條裝置的句柄。

hAgentSession

要擷取其資訊的代理程式會話標識碼。

lpAgentSessionInfo

LINEAGENTSESSIONINFO 類型的結構的指標。成功完成要求時，此結構會填入代理程式會話統計數據。在呼叫 lineGetAgentSessionInfo 函式之前，應用程式必須設定此結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。

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

傳回值

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

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