共用方式為


ITAgent::CreateSession 方法 (tapi3.h)

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
pACDGrouppAddress 自變數無效。
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

ITACDGroup

ITAddress

ITAgent

ITAgent::CreateSessionWithPIN

ITAgentSession