lineCreateAgentSessionA 函式 (tapi.h)
lineCreateAgentSession 函式會建立新的 AgentSession 物件。 它會產生要傳送至已註冊 Proxy 函式處理程式 的LINE_PROXYREQUEST 訊息，參考類型為 LINEPROXYREQUEST_CREATEAGENTSESSION 的 LINEPROXYREQUEST 結構。
語法
LONG lineCreateAgentSessionA(
HLINE hLine,
HAGENT hAgent,
LPCSTR lpszAgentPIN,
DWORD dwWorkingAddressID,
LPGUID lpGroupID,
LPHAGENTSESSION lphAgentSession
);
參數
hLine
線條裝置的句柄。
hAgent
要為其建立會話之代理程式的標識碼。
lpszAgentPIN
包含代理程式 PIN 或密碼之 Null 終止 Unicode 字串的指標。 在處理需要針對每個會話建立 (或群組登入) 個別 PIN 的舊版 ACD 系統時使用。 使用操作系統的使用者登入進行驗證的 ACD 系統， lpszAgentPIN 會設定為 NULL。
dwWorkingAddressID
代理程式將在此會話接收呼叫的位址標識碼。
lpGroupID
GUID 的指標，識別正在建立會話的群組。
lphAgentSession
ACD Proxy 所傳回之已建立之代理程式會話的句柄。 代理程式處理程式 Proxy 應用程式負責產生和維護這些標識碼的唯一性。
傳回值
如果異步操作啟動時，會傳回要求標識符;否則，函式會傳回下列其中一個錯誤值：
LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED。
備註
注意
tapi.h 標頭會將 lineCreateAgentSession 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |