ITAgentHandler::CreateAgent 方法 (tapi3.h)

CreateAgent方法會建立 Agent 物件。

語法

HRESULT CreateAgent(
  [out] ITAgent **ppAgent
);

參數

[out] ppAgent

ITAgent介面的指標。

傳回值

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

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

備註

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

規格需求

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

另請參閱

CreateAgentWithID

ITAgent

ITAgentHandler