lineCreateAgentA function (tapi.h)
lineCreateAgent 函式會建立新的 Agent 物件。 它會產生 LINE_PROXYREQUEST 訊息以傳送至已註冊的 Proxy 函式處理程式,並參考類型LINEPROXYREQUEST_CREATEAGENT LINEPROXYREQUEST 結構。
語法
LONG lineCreateAgentA(
HLINE hLine,
LPCSTR lpszAgentID,
LPCSTR lpszAgentPIN,
LPHAGENT lphAgent
);
參數
hLine
線路裝置的句柄。
lpszAgentID
null 的指標包含代理程式識別碼的終止 Unicode 字串。 使用舊版 ACD 系統時使用。 使用作業系統的使用者登入進行驗證的 ACD 系統,lpszAgentID 設定為 NULL。
lpszAgentPIN
null 的指標終止的 Unicode 字串,其中包含代理程式 PIN 或密碼。 使用舊版 ACD 系統時使用。 使用作業系統的使用者登入進行驗證的 ACD 系統,lpszAgentPIN 會設定為 NULL。
lphAgent
ACD Proxy 所傳回之已建立代理程式的句柄。 代理程式處理程式 Proxy 應用程式負責產生和維護此標識碼的唯一性。
傳回值
如果異步操作啟動時,會傳回要求標識符;否則,函式會傳回下列其中一個錯誤值:
LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_UNINITIALIZED。
言論
注意
tapi.h 標頭會根據 UNICODE 預處理器常數的定義,將 lineCreateAgent 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
目標平臺 | 窗戶 |
標頭 | tapi.h |
連結庫 | Tapi32.lib |
DLL | Tapi32.dll |