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 erfolgreicher Ausführung 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 Nothing als ein Parameter festgelegt. Dies ist bei dieser Verwendung nicht zulässig.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Es ist nicht genügend Arbeitsspeicher zum Klonen des Objekts vorhanden.

Bemerkungen

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 beibehalten möchten, während Sie eine neue Kopie ändern. Sie können diese Methode auch verwenden, 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 erzeugen. Anschließend können Sie die Objekte ändern und jedem bestimmte Werte zuordnen.

Es ist nicht möglich, diese Methode zum Konvertieren einer Klassendefinition in eine Instanz oder zum Konvertieren einer Instanz in eine Klassendefinition zu verwenden.

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