ITAgent：：CreateSession 方法 (tapi3.h)

發行項
03/02/2024

CreateSession 方法會為輸入 ACD 群組和位址建立新的代理程式會話。

語法

HRESULT CreateSession(
  [in]  ITACDGroup     *pACDGroup,
  [in]  ITAddress      *pAddress,
  [out] ITAgentSession **ppAgentSession
);

參數

[in] pACDGroup

ITACDGroup 介面的指標。

[in] pAddress

ITAddress 物件的指標，可用於接收ACD呼叫。

[out] ppAgentSession

所建立物件的 ITAgentSession 介面指標。

傳回值

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

值	意義
S_OK	方法成功。
E_POINTER	ppAgentSession 參數不是有效的指標。
E_UNEXPECTED	無法開啟目標位址的行。
E_INVALIDARG	pACDGroup 或 pAddress 自變數無效。
E_OUTOFMEMORY	記憶體不足，無法執行作業。
TAPI_E_TIMEOUT	作業失敗，因為 TAPI 3 DLL 已逾時。逾時間隔為兩分鐘。

備註

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

某些電話環境需要個人標識碼才能開啟會話。請參閱 CreateSessionWithPIN。

規格需求

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

另請參閱

IEnumAgentSession

ITAgent：：CreateSessionWithPIN