SWbemObject.SpawnDerivedClass_-Methode

Verwenden Sie die SpawnDerivedClass_-Methode des SWbemObject-Objekts, um ein abgeleitetes Klassenobjekt auf der Grundlage des aktuellen Objekts zu erstellen. Das Objekt muss eine Klassendefinition sein, die zur übergeordneten Klasse des erzeugten Objekts wird.

Eine Erläuterung dieser Syntax finden Sie in den Dokumentkonventionen für die Skripterstellungs-API.

Syntax

objNewClass = .SpawnDerivedClass_( _
  [ ByVal iFlags ] _
)

Parameter

iFlags [optional]

Ist reserviert und muss bei Angabe auf „0“ festgelegt werden.

Rückgabewert

Wenn der Aufruf erfolgreich ist, enthält das SWbemObject-Objekt das neue Klassendefinitionsobjekt. Im Falle eines Fehlers wird kein Objekt zurückgegeben.

Fehlercodes

Nach Abschluss der SpawnDerivedClass_-Methode enthält das Err-Objekt möglicherweise einen der Fehlercodes aus der folgenden Liste:

wbemErrFailed – 2147749889 (0x80041001)

Unbekannter Fehler.

wbemErrIllegalOperation – 2147749918 (0x8004101E)

Der Benutzer hat einen ungültigen Vorgang angefordert (beispielsweise das Erstellen einer Klasse auf der Grundlage einer Instanz).

wbemErrIncompleteClass – 2147749920 (0x80041020)

Die Quellklasse wurde nicht vollständig definiert oder nicht bei WMI registriert. Daher wird keine neue abgeleitete Klasse zugelassen.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Es ist nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs vorhanden.

Bemerkungen

Das zurückgegebene Objekt wird automatisch zu einer Unterklasse des aktuellen Objekts. Dieses Verhalten kann nicht außer Kraft gesetzt werden. Es gibt keine andere Methode zum Erstellen abgeleiteter Klassen.

Sie können keine abgeleitete Klasse auf der Grundlage einer Klasse erstellen, die für Ihren eigenen Clientprozess lokal ist. Bevor Sie diese Methode zum Erstellen einer abgeleiteten Klasse verwenden, müssen Sie die Basisklasse erstellen. Rufen Sie zum Erstellen der Basisklasse SWbemObject.Put_ auf, und rufen Sie die Basisklasse mithilfe von SWbemServices.Get ab.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Header	Wbemdisp.h
Typbibliothek	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject