Sdílet prostřednictvím

SpawnInstance – funkce

Vytvoří novou instanci třídy.

Poznámka

Toto rozhraní API je pouze pro interní použití. Není určen pro použití z vývojářského kódu.

Syntaxe

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

Parametry

vFunc
[v] Tento parametr se nepoužívá.

ptr
[v] Ukazatel na instanci IWbemClassObject .

lFlags
[v] Vyhrazena. Tento parametr musí být 0.

ppNewInstance
[out] Přijme ukazatel na novou instanci třídy. Pokud dojde k chybě, nový objekt se nevrátí a ppNewInstance ponechá se beze změny.

Vrácená hodnota

Následující hodnoty vrácené touto funkcí jsou definovány v souboru hlaviček WbemCli.h nebo je můžete definovat jako konstanty ve vašem kódu:

Konstanta Hodnota Popis
WBEM_E_INCOMPLETE_CLASS 0x80041020 ptr není platná definice třídy a nemůže vytvořit nové instance. Buď je neúplný, nebo nebyl zaregistrován ve službě Správa systému Windows voláním PutClassWmi.
WBEM_E_OUT_OF_MEMORY 0x80041006 K dokončení operace není k dispozici dostatek paměti.
WBEM_E_INVALID_PARAMETER 0x80041008 ppNewClass je null.
WBEM_S_NO_ERROR 0 Volání funkce bylo úspěšné.

Poznámky

Tato funkce zabalí volání metody IWbemClassObject::SpawnInstance .

ptr musí být definice třídy získaná ze služby Správa systému Windows. (Mějte na paměti, že vytvoření instance z instance je podporováno, ale vrácená instance je prázdná.) Tuto definici třídy pak použijete k vytvoření nových instancí. Volání funkce PutInstanceWmi je vyžadováno, pokud chcete zapsat instanci do služby Správa systému Windows.

Nový objekt vrácený v ppNewClass se automaticky stane podtřídou aktuálního objektu. Toto chování nelze přepsat. Neexistuje žádná jiná metoda, pomocí které by bylo možné vytvářet podtřídy (odvozené třídy).

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: WMINet_Utils.idl

Verze rozhraní .NET Framework: K dispozici od verze 4.7.2

Viz také

  • Last updated on