SpawnDerivedClass-Funktion

  • Artikel

Erstellt ein neu abgeleitetes Klassenobjekt aus einem angegebenen Objekt.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

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

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Ein Zeiger auf eine IWbemClassObject-Instanz.

lFlags
[in]: Reserviert Dieser Parameter muss 0 sein.

ppNewClass
[out] Empfängt den Zeiger auf das neue Klassendefinitionsobjekt. Wenn ein Fehler auftritt, wird kein neues Objekt zurückgegeben, und ppNewClass bleibt unverändert. Sein Wert darf nicht null sein.

Rückgabewert

Die folgenden von dieser Funktion zurückgegebenen Werte werden in der WbemCli.h-Headerdatei definiert, oder Sie können sie als Konstanten im Code definieren:

Konstante Wert BESCHREIBUNG
WBEM_E_FAILED 0x80041001 Es ist ein allgemeiner Fehler aufgetreten.
WBEM_E_INVALID_OPERATION 0x80041016 Ein ungültiger Vorgang wurde angefordert, beispielsweise das Erzeugen einer Klasse aus einer Instanz.
WBEM_E_INCOMPLETE_CLASS Die Quellklasse wurde nicht vollständig definiert oder bei der Windows-Verwaltung registriert, weshalb eine neue abgeleitete Klasse nicht zulässig ist.
WBEM_E_OUT_OF_MEMORY 0x80041006 Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
WBEM_E_INVALID_PARAMETER 0x80041008 ppNewClass ist null.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemClassObject::SpawnDerivedClass-Methode.

ptr muss eine Klassendefinition sein, die zur übergeordneten Klasse des erzeugten Objekts wird. Das zurückgegebene Objekt wird zu einer Unterklasse des aktuellen Objekts.

Das in ppNewClass zurückgegebene neue Objekt wird automatisch zu einer Unterklasse des aktuellen Objekts. Dieses Verhalten kann nicht außer Kraft gesetzt werden. Es gibt keine andere Methode, mit der Unterklassen (abgeleitete Klassen) erstellt werden können.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: Seit Version 4.7.2 verfügbar

Siehe auch