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