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 |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID _ SWbemObject |
| IID |
IID _ ISWbemObject |