IWbemClassObject::Clone-Methode (wbemcli.h)

  • Artikel

Die IWbemClassObject::Clone-Methode gibt ein neues Objekt zurück, das ein vollständiger Klon des aktuellen Objekts ist. Das neue Objekt verfügt über eine COM-Verweisanzahl von 1.

Syntax

HRESULT Clone(
  [out] IWbemClassObject **ppCopy
);

Parameter

[out] ppCopy

Dieser Parameter darf nicht NULL sein. Sie empfängt die Kopie des aktuellen Objekts. Sie müssen IWbemClassObject::Release für dieses Objekt aufrufen, wenn es nicht mehr benötigt wird.

Ein neues Objekt wird bei einem Fehler nicht zurückgegeben.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Hinweise

Verwenden Sie diese Methode, um eine Klassendefinition zu duplizieren oder eine instance zu duplizieren. Dies kann hilfreich sein, wenn die originale Kopie des Objekts zu Sicherungszwecken erforderlich ist, während eine neue Kopie geändert wird. Sie können diese Methode auch verwenden, um viele neue Instanzen aus einer einzelnen Quellinstanz zu erstellen. Verwenden Sie beispielsweise IWbemClassObject::SpawnInstance, um eine einzelne Start-instance zu erstellen, und verwenden Sie IWbemClassObject::Clone, um schnell 100 Kopien der instance zu erstellen. Jedes Objekt kann anschließend geändert werden, um seine spezifischen Werte zu übernehmen.

Es ist nicht möglich, mit dieser Methode eine Klassendefinition in eine instance oder eine instance in eine Klassendefinition zu konvertieren.

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