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
包含代理程式 PIN 或密碼之 Null 終止 Unicode 字串的指標。 使用舊版 ACD 系統時使用。 使用操作系統的使用者登入進行驗證的 ACD 系統， lpszAgentPIN 會設定為 NULL。
lphAgent
ACD Proxy 傳回的已建立代理程式的句柄。 代理程式處理程式 Proxy 應用程式負責產生和維護此標識碼的唯一性。
傳回值
如果異步操作啟動時，傳回要求標識符;否則，函式會傳回下列其中一個錯誤值：
LINEERR_INVALLINEHANDLE、LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_UNINITIALIZED。
備註
注意
tapi.h 標頭會將 lineCreateAgent 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |