lineGetAgentSessionInfo 函式 (tapi.h)
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。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |