IWbemClassObject::SpawnInstance-Methode (wbemcli.h)

  • Artikel

Verwenden Sie die IWbemClassObject::SpawnInstance-Methode, um eine neue instance einer Klasse zu erstellen. Das aktuelle Objekt muss eine Klassendefinition sein, die von der Windows-Verwaltung mit IWbemServices::GetObject, IWbemServices::CreateClassEnum oder IWbemServices::CreateClassEnumAsync abgerufen wurde. Verwenden Sie dann diese Klassendefinition, um neue Instanzen zu erstellen.

Ein Aufruf von IWbemServices::P utInstance ist erforderlich, um die instance tatsächlich in die Windows-Verwaltung zu schreiben. Wenn Sie das Objekt verwerfen möchten, bevor Sie IWbemServices::P utInstance aufrufen, rufen Sie einfach IWbemClassObject::Release auf.

Beachten Sie, dass das Spawnen eines instance aus einem instance unterstützt wird, die zurückgegebene instance jedoch leer ist.

Syntax

HRESULT SpawnInstance(
  [in]  long             lFlags,
  [out] IWbemClassObject **ppNewInstance
);

Parameter

[in] lFlags

Reserviert. Dieser Parameter muss 0 sein.

[out] ppNewInstance

Kann nicht NULL sein. Es empfängt eine neue instance der -Klasse. Der Aufrufer muss IWbemClassObject::Release aufrufen, wenn der Zeiger nicht mehr erforderlich ist. Bei Einem Fehler wird kein neues Objekt zurückgegeben, und der Zeiger 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.

Anforderungen

   
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::PutInstance