SWbemObject.Clone_ method
The Clone_ method of the SWbemObject object returns a new object that is a clone of the current object.
For an explanation of this syntax, see Document Conventions for the Scripting API.
Syntax
objWbemObject = .Clone_( _
)
Parameters
This method has no parameters.
Return value
If successful, this method returns a new SWbemObject object.
Error codes
After completion of the Clone_ method, the Err object may contain one of the error codes below.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Unspecified error.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
Nothing was specified as a parameter, and it is not acceptable in this usage.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
Not enough memory to clone the object.
Remarks
Use the Clone_ method to duplicate a class definition or an instance. This is useful when you need the original copy of the object for backup purposes while you are modifying a new copy. Likewise, use this method to create many new instances from a single source instance. For example, use SWbemObject.SpawnInstance_ to create a single starting instance, and use SWbemObject.Clone_ to produce 100 copies of the instance quickly. Subsequently, you can modify the objects, giving each one specific values.
It is not possible to use this method to convert a class definition to an instance, or to convert an instance to a class definition.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Header |
|
| Type library |
|
| DLL |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |