描述
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。 |