SpawnInstance, functie

Hiermee maakt u een nieuw exemplaar van een klasse.

Notitie

Deze API is alleen voor intern gebruik. Het is niet bedoeld voor gebruik vanuit code voor ontwikkelaars.

Syntaxis

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

Parameters

vFunc
[in] Deze parameter is niet gebruikt.

ptr
[in] Een verwijzing naar een IWbemClassObject-exemplaar .

lFlags
[in] Gereserveerd. Deze parameter moet 0 zijn.

ppNewInstance
[uit] Hiermee ontvangt u de aanwijzer naar het nieuwe exemplaar van de klasse. Als er een fout optreedt, wordt er geen nieuw object geretourneerd en ppNewInstance blijft het ongewijzigd.

Retourwaarde

De volgende waarden die door deze functie worden geretourneerd, worden gedefinieerd in het headerbestand WbemCli.h , of u kunt ze definiëren als constanten in uw code:

Constant	Waarde	Beschrijving
WBEM_E_INCOMPLETE_CLASS	0x80041020	ptr is geen geldige klassedefinitie en kan geen nieuwe exemplaren tot gevolg hebben. Het is onvolledig of is niet geregistreerd bij Windows Management door PutClassWmi aan te roepen.
WBEM_E_OUT_OF_MEMORY	0x80041006	Er is onvoldoende geheugen beschikbaar om de bewerking te voltooien.
WBEM_E_INVALID_PARAMETER	0x80041008	ppNewClass is null.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Deze functie verpakt een aanroep naar de methode IWbemClassObject::SpawnInstance .

ptr moet een klassedefinitie zijn die is verkregen van Windows Management. (Houd er rekening mee dat het uitzetten van een exemplaar van een exemplaar wordt ondersteund, maar dat het geretourneerde exemplaar leeg is.) Vervolgens gebruikt u deze klassedefinitie om nieuwe exemplaren te maken. Een aanroep van de functie PutInstanceWmi is vereist als u het exemplaar naar Windows Management wilt schrijven.

Het nieuwe object dat in wordt geretourneerd, ppNewClass wordt automatisch een subklasse van het huidige object. Dit gedrag kan niet worden overschreven. Er is geen andere methode waarmee subklassen (afgeleide klassen) kunnen worden gemaakt.

Vereisten

Platforms: Zie Systeemvereisten.

Header: WMINet_Utils.idl

.NET Framework versies: beschikbaar sinds 4.7.2

Zie ook

• WMI en prestatiemeteritems (niet-beheerde API-verwijzing)