Freigeben über


IWbemClassObject::SpawnDerivedClass-Methode (wbemcli.h)

Verwenden Sie die IWbemClassObject::SpawnDerivedClass-Methode , um ein neu abgeleitetes Klassenobjekt aus dem aktuellen Objekt zu erstellen. Das aktuelle Objekt muss eine Klassendefinition sein, die zur übergeordneten Klasse des spawnten Objekts wird. Das zurückgegebene Objekt wird zu einer Unterklasse des aktuellen Objekts.

Syntax

HRESULT SpawnDerivedClass(
  [in]  long             lFlags,
  [out] IWbemClassObject **ppNewClass
);

Parameter

[in] lFlags

Reserviert. Dieser Parameter muss 0 sein.

[out] ppNewClass

Kann nicht NULL sein. Dadurch wird der Zeiger auf das neue Klassendefinitionsobjekt empfangen. Der Aufrufer muss IWbemClassObject::Release aufrufen, wenn das Objekt nicht mehr erforderlich ist, in der Regel nachdem Sie IWbemServices::P utClass aufgerufen haben, um die Klassendefinition zu schreiben. Bei Einem Fehler wird kein neues Objekt zurückgegeben, und ppNewClass bleibt unverändert.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Hinweise

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.

Sie können keine abgeleitete Klasse auf der Grundlage einer Klasse erstellen, die für Ihren eigenen Clientprozess lokal ist. Die übergeordnete Klasse (Basisklasse) muss mithilfe von IWbemServices::P utClass bei der Windows-Verwaltung erstellt und registriert und dann mithilfe von IWbemServices::GetObject abgerufen werden, bevor diese Methode zum Erstellen einer abgeleiteten Klasse verwendet werden kann.

Um eine Klassenhierarchie zu erstellen, müssen Sie die erste Klasse mit IWbemServices::P utClass erstellen, sie mithilfe von IWbemServices::GetObject abrufen und das abgerufene Objekt verwenden, um die neu abgeleitete Klasse zu erstellen. Anschließend muss diese neu abgeleitete Klasse mit IWbemServices::P utClass erstellt werden. Zum Erstellen anderer abgeleiteter Klassen müssen Sie IWbemServices::GetObject und dann IWbemClassObject::SpawnDerivedClass usw. in einem Zyklus für jede neue Ableitungsebene aufrufen. Sie müssen dieses Verfahren befolgen, um Versionsfehler und Parallelitätskonflikte zu vermeiden. Weitere Informationen zum Erstellen einer Klasse ohne übergeordnetes Element finden Sie unter Erstellen einer Klasse.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile wbemcli.h (include Wbemidl.h)
Bibliothek WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Weitere Informationen

IWbemClassObject

IWbemServices::GetObject

IWbemServices::PutClass