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
null 的指標終止的 Unicode 字串,其中包含代理程式 PIN 或密碼。 用於使用需要每個建立之會話的個別 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 標頭會根據 UNICODE 預處理器常數的定義,將 lineCreateAgentSession 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
目標平臺 | 窗戶 |
標頭 | tapi.h |
連結庫 | Tapi32.lib |
DLL | Tapi32.dll |
另請參閱
關於通話中心控件 的