SpawnDerivedClass 函式
從指定的物件建立新的衍生類別物件。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT SpawnDerivedClass (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LONG lFlags,
[out] IWbemClassObject** ppNewClass);
參數
vFunc
[in] 此參數未使用。
ptr
[in] IWbemClassObject 執行個體的指標。
lFlags
[in] 保留。 此參數必須是 0。
ppNewClass
[out] 接收新類別定義物件的指標。 如果發生錯誤,則不會傳回新的物件,而且 ppNewClass
會保持未修改狀態。 其值不能是 null
。
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中,或者,您可以將其定義為程式碼中的常數:
常數 | 值 | 描述 |
---|---|---|
WBEM_E_FAILED |
0x80041001 | 發生一般失敗。 |
WBEM_E_INVALID_OPERATION |
0x80041016 | 已要求無效作業,例如從執行個體繁衍類別。 |
WBEM_E_INCOMPLETE_CLASS |
來源類別未完全定義或向 Windows 管理註冊,因此不允許新的衍生類別。 | |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 可用的記憶體不足,無法完成作業。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | ppNewClass 為 null 。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝向 IWbemClassObject::SpawnDerivedClass 方法發出的呼叫。
ptr
必須是類別定義,此定義會成為繁衍物件的父類別。 傳回的物件會變成目前物件的子類別。
ppNewClass
中傳回的新物件會自動成為目前物件的子類別。 無法覆寫此行為。 沒有其他可據以建立子類別 (衍生類別) 的方法。
規格需求
平台:請參閱系統需求。
標頭:WMINet_Utils.idl
.NET Framework版本:自 4.7.2 起可用