Redigera

Dela via


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
Wbemdisp.h
Type library
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemObject
IID
IID_ISWbemObject