SpawnInstance 函式
建立類別的新執行個體。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT SpawnInstance (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LONG lFlags,
[out] IWbemClassObject** ppNewInstance);
參數
vFunc
[in] 此參數未使用。
ptr
[in] IWbemClassObject 執行個體的指標。
lFlags
[in] 保留。 此參數必須是 0。
ppNewInstance
[out] 接收新的類別執行個體的指標。 如果發生錯誤，則不會傳回新的物件，而且 ppNewInstance 會保持未修改狀態。
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_E_INCOMPLETE_CLASS |
0x80041020 | ptr 不是有效的類別定義，無法繁衍新的執行個體。 它不完整，或尚未藉由呼叫 PutClassWmi 向 Windows 管理註冊。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 可用的記憶體不足，無法完成作業。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | ppNewClass 為 null。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝向 IWbemClassObject::SpawnInstance 方法發出的呼叫。
ptr 必須是從 Windows 管理取得的類別定義。 (請注意，支援從執行個體繁衍執行個體，但傳回的執行個體是空的)。接著，您可以使用此類別定義建立新的執行個體。 如果您想要將執行個體寫入至 Windows 管理，則必須呼叫 PutInstanceWmi 函式。
ppNewClass 中傳回的新物件會自動成為目前物件的子類別。 無法覆寫此行為。 沒有其他可據以建立子類別 (衍生類別) 的方法。
規格需求
平台：請參閱系統需求。
標頭：WMINet_Utils.idl
.NET Framework版本：自 4.7.2 起提供
