SpawnInstance függvény

Létrehoz egy osztály új példányát.

Megjegyzés

Ez az API csak belső használatra készült. Nem fejlesztői kódból való használatra készült.

Szintaxis

HRESULT SpawnInstance (
   [in] int                  vFunc,
   [in] IWbemClassObject*    ptr,
   [in] LONG                 lFlags,
   [out] IWbemClassObject**  ppNewInstance);

Paraméterek

vFunc
[in] Ez a paraméter nincs használatban.

ptr
[in] Egy IWbemClassObject-példányra mutató mutató.

lFlags
[in] Fenntartva. Ennek a paraméternek 0-nak kell lennie.

ppNewInstance
[kifelé] Fogadja az osztály új példányára mutató mutatót. Hiba esetén a rendszer nem ad vissza új objektumot, és ppNewInstance nem módosítatlan marad.

Visszatérési érték

A függvény által visszaadott alábbi értékek a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban:

Állandó	Érték	Leírás
WBEM_E_INCOMPLETE_CLASS	0x80041020	ptr érvénytelen osztálydefiníció, és nem tud új példányokat létrehozni. Vagy hiányos, vagy nem lett regisztrálva a Windows Managementben a PutClassWmi meghívásával.
WBEM_E_OUT_OF_MEMORY	0x80041006	Nincs elegendő memória a művelet végrehajtásához.
WBEM_E_INVALID_PARAMETER	0x80041008	A ppNewClass értéke null.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.

Megjegyzések

Ez a függvény becsomagolja az IWbemClassObject::SpawnInstance metódus hívását .

ptr A Windows Managementből beszerzett osztálydefiníciónak kell lennie. (Vegye figyelembe, hogy egy példány példányból történő ívása támogatott, de a visszaadott példány üres.) Ezután ezzel az osztálydefinícióval hozhat létre új példányokat. A PutInstanceWmi függvény meghívására akkor van szükség, ha a példányt a Windows Managementbe szeretné írni.

A visszaadott ppNewClass új objektum automatikusan az aktuális objektum alosztályává válik. Ez a viselkedés nem bírálható felül. Nincs más módszer, amellyel alosztályok (származtatott osztályok) hozhatók létre.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: WMINet_Utils.idl

.NET-keretrendszer verziók: 4.7.2 óta érhető el

Lásd még

• WMI- és teljesítményszámlálók (nem felügyelt API-referencia)