ObjectContext::CreateInstance 方法 (comsvcs.h)
使用目前物件的內容建立物件。
只有當物件元件向 COM+ 註冊時,物件才會有內容。
語法
HRESULT CreateInstance(
[in] BSTR bstrProgID,
[out] VARIANT *pObject
);
參數
[in] bstrProgID
要具現化之物件類型的 ProgID。
[out] pObject
新物件的參考。
傳回值
這個方法可以傳回標準傳回值E_INVALIDARG、E_OUTOFMEMORY和E_FAIL,以及下列值。
傳回碼 | 描述 |
---|---|
|
已成功完成命令。 |
|
發生意外錯誤。 如果某個物件將其 ObjectContext 指標傳遞至另一個物件,而另一個物件會使用此指標呼叫 CreateInstance ,就會發生這種情況。 ObjectContext 指標在原本取得對象的內容之外無效。 |
備註
當您使用 CreateInstance 建立物件時,新對象的內容衍生自目前物件的 ObjectContext 和新物件元件的宣告式屬性。 新物件一律會在與建立它的物件相同的活動中執行。 如果目前物件有交易,新物件的元件交易屬性會判斷新物件是否在該交易的範圍內執行。
如果元件的異動屬性設定需要交易或支援交易,新物件就會繼承其建立者的異動。 如果元件的交易屬性需要新的交易,COM+ 會起始新物件的新交易。 如果元件的異動屬性不支援交易,則新物件不會在任何交易下執行。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | comsvcs.h |