ITAgentHandler：：CreateAgentWithID 方法 (tapi3.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 介面的指標。

傳回值

這個方法可以傳回下列其中一個值。

值	意義
S_OK	方法成功。
E_INVALIDARG	pPIN 參數為 NULL。
E_POINTER	ppAgent 參數不是有效的指標。
E_OUTOFMEMORY	記憶體不足，無法執行作業。
TAPI_E_TIMEOUT	作業失敗，因為 TAPI 3 DLL 已逾時。逾時間隔為兩分鐘。

備註

應用程式必須使用 SysAllocString 為 pID 和 pPIN 參數配置記憶體，並在不再需要變數時使用 SysFreeString 釋放記憶體。

TAPI 會在 ITAgentHandler：：CreateAgentWithID 所傳回的 ITAgent 介面上呼叫 AddRef 方法。 應用程式必須在 ITAgent 介面上呼叫 Release，以釋放與其相關聯的資源。

規格需求

需求	值
目標平台	Windows
標頭	tapi3.h (包括 Tapi3.h)
程式庫	Uuid.lib
Dll	Tapi3.dll

另請參閱

CreateAgent

ITAgent

ITAgentHandler