SWbemObject.Clone-Methode _

Die _ Clone-Methode des SWbemObject-Objekts gibt ein neues -Objekt zurück, das ein Klon des aktuellen -Objekts ist.

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

Syntax

objWbemObject = .Clone_( _
)

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Bei Erfolg gibt diese Methode ein neues SWbemObject-Objekt zurück.

Fehlercodes

Nach Abschluss der Clone-Methode _ kann das Err-Objekt einen der folgenden Fehlercodes enthalten.

wbemErrFailed – 2147749889 (0x80041001)

Unbekannter Fehler.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Es wurde nichts als Parameter angegeben, und dies ist in dieser Verwendung nicht akzeptabel.

wbemErrOutOfMemory : 2147749894 (0x80041006)

Nicht genügend Arbeitsspeicher zum Klonen des Objekts.

Hinweise

Verwenden Sie die _ Clone-Methode, um eine Klassendefinition oder eine Instanz zu duplizieren. Dies ist nützlich, wenn Sie die ursprüngliche Kopie des Objekts zu Sicherungszwecken benötigen, während Sie eine neue Kopie ändern. Verwenden Sie diese Methode ebenfalls, um viele neue Instanzen aus einer einzelnen Quellinstanz zu erstellen. Verwenden Sie beispielsweise SWbemObject.SpawnInstance, _ um eine einzelne Startinstanz zu erstellen, und verwenden Sie SWbemObject.Clone, _ um schnell 100 Kopien der Instanz zu erstellen. Anschließend können Sie die Objekte ändern, indem Sie jeweils einen bestimmten Wert erhalten.

Es ist nicht möglich, diese Methode zu verwenden, um eine Klassendefinition in eine -Instanz oder eine -Instanz in eine Klassendefinition zu konvertieren.

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