勇芳软件工作室.汉化:  Windows Management Instrumentation > COM API for WMI > Interfaces > IWbemClassObject >

Clone Method

Previous pageReturn to chapter overviewNext page

描述

 

IWbemClassObject.Clone方法返回一个新对象,该对象是当前对象的完整克隆。新对象的COM引用计数为1。

 

C++ 语法

 

HRESULT Clone(

[out]  IWbemClassObject **ppCopy

);

 

PowerBASIC 语法

 

METHOD Clone ( _

BYREF ppCopy AS IWbemClassObject _

) AS LONG

 

参数

 

ppCopy

 

此参数不能为NULL。它接收当前对象的副本。当不再需要此对象时,必须调用IWbemClassObject.Release.

 

错误时不返回新对象。

 

返回值

 

此方法返回一个HRESULT,指示方法调用的状态。下表列出了HRESULT中包含的值。

 

退货代码

描述

WBEM_E_FAILED

已经有一般的失败。

WBEM_E_INVALID_PARAMETER

NULL被指定为一个参数,在此使用中是不合法的。

WBEM_E_OUT_OF_MEMORY

没有足够的内存克隆对象。

WBEM_S_NO_ERROR

通话成功。

 

备注

 

使用此方法复制类定义或复制实例。当新的副本被修改时,当备份时需要对象的原始副本时,这是有用的。同样,使用此方法可以从单个源实例创建许多新实例。例如,使用IWbemClassObject.SpawnInstance创建单个起始实例,并使用IWbemClassObject.Clone快速生成100个副本。随后可以修改每个对象以承担其特定值。

 

不可能使用此方法将类定义转换为实例,或将实例转换为类定义。

 

要求

 

客户

需要Windows Vista,Windows XP,Windows 2000 Professional,Windows NT Workstation 4.0 SP4及更高版本,Windows Me,Windows 98或Windows 95。

服务器

需要Windows Server 2008,Windows Server 2003,Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。

在Wbemcli.inc中声明。

DLL

需要Cimwin32.dll。

需要Esscli.dll。

需要Evntrprv.dll。

需要Fastprox.dll。

需要Framedyn.dll。

需要Krnlprov.dll。

需要Ncprov.dll。

需要Wbemcore.dll。

需要Wbemess.dll。

需要Wmipiprt.dll。