ITAgentHandler：：CreateAgentWithID 方法 (tapi3cc.h)
CreateAgentWithID方法會根據代理程式識別碼建立 Agent 物件。 此識別碼是識別舊版 ACD 系統上代理程式的字串。 如果系統也需要 PIN 或密碼才能登入群組，您可以使用此方法來設定 PIN 或密碼。
語法
HRESULT CreateAgentWithID(
[in] BSTR pID,
[in] BSTR pPIN,
[out] ITAgent **ppAgent
);
參數
[in] pID
包含代理程式識別碼的 BSTR 指標。
[in] pPIN
包含代理程式 PIN 的 BSTR 指標。
[out] ppAgent
ITAgent介面的指標。
傳回值
這個方法可以傳回其中一個值。
| 值 | 意義 |
|---|---|
|
方法成功。 |
|
pPIN參數為Null。 |
|
ppAgent參數不是有效的指標。 |
|
記憶體不足，無法執行作業。 |
|
作業失敗，因為 TAPI 3 DLL 已逾時。逾時間隔為兩分鐘。 |
備註
應用程式必須使用 SysAllocString 來配置 pID 和 pPIN 參數的記憶體，並使用 SysFreeString 在不再需要變數時釋放記憶體。
TAPI 會在ITAgentHandler：：CreateAgentWithID傳回的 ITAgent介面上呼叫AddRef方法。 應用程式必須在ITAgent介面上呼叫Release，以釋放與其相關聯的資源。
規格需求
| 目標平台 | Windows |
| 標頭 | tapi3cc.h (包含 Tapi3.h) |
| 程式庫 | Uuid.lib |
| Dll | Tapi3.dll |