(comsvcs.h) IObjectContext：：CreateInstance 方法

使用目前物件的內容建立物件。

語法

HRESULT CreateInstance(
  [in]  REFCLSID rclsid,
  [in]  REFIID   riid,
  [out] LPVOID   *ppv
);

[in] rclsid

要具現化之物件類型的CLSID。

[in] riid

您想要具現化物件所實作的任何介面。

[out] ppv

新物件上所要求介面的參考。如果具現化失敗，此參數會設定為 NULL。

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

傳回碼	描述
S_OK	已成功完成命令。
REGDB_E_CLASSNOTREG	clsid 指定的元件未註冊為 COM 元件。
E_OUTOFMEMORY	記憶體不足，無法具現化物件。
E_INVALIDARG	在 ppvObj 參數中傳遞的自變數無效。
E_UNEXPECTED	發生意外錯誤。如果某個物件將其 IObjectContext 指標傳遞至另一個物件，而另一個物件會使用此指標呼叫 CreateInstance ，就會發生這種情況。 IObjectContext 指標在最初取得它的物件內容之外無效。

CreateInstance 會建立 COM 物件。不過，只有當物件元件向 COM+ 註冊時，物件才會有內容。

當您使用 CreateInstance 建立物件時，新對象的內容衍生自目前物件的 IObjectContext 和新物件元件的宣告式屬性。新物件一律會在與建立它的物件相同的活動中執行。如果目前物件有交易，新物件的元件交易屬性會判斷新物件是否在該交易的範圍內執行。

如果元件的異動屬性設定需要交易或支援交易，新物件就會繼承其建立者的異動。如果元件的交易屬性需要新的交易，COM+ 會起始新物件的新交易。如果元件的異動屬性不支援交易，則新物件不會在任何交易下執行。

CreateInstance 一律會傳回新具現化物件上的 IUnknown 介面。您應該立即將傳回的值轉換為要與新物件通訊的介面。您傳入 riid 參數的介面識別碼不需要與您轉換傳回值的介面相同，但它必須是您所具現化物件所實作的介面。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	comsvcs.h