Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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 in the following table.

Error (Name/Dec/Hex)Meaning
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.

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Type library

Wbemdisp.tlb

DLL

Wbemdisp.dll

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.