IWbemClassObject::Clone 方法 (wbemcli.h)
IWbemClassObject::Clone 方法返回一个新对象,该对象是当前对象的完整克隆。 新对象的 COM 引用计数为 1。
语法
HRESULT Clone(
[out] IWbemClassObject **ppCopy
);
参数
[out] ppCopy
此参数不能为 NULL。 它接收当前对象的副本。 如果不再需要此对象,则必须对此对象调用 IWbemClassObject::Release 。
错误时不会返回新对象。
返回值
此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。 有关常规 HRESULT 值,请参阅 系统错误代码。
注解
使用此方法可以复制类定义或复制实例。 这在修改新副本时需要对象的原始副本用于备份时非常有用。 同样,可以使用此方法从单个源实例创建许多新实例。 例如,使用 IWbemClassObject::SpawnInstance 创建单个起始实例,并使用 IWbemClassObject::Clone 快速生成实例的 100 个副本。 随后可以修改每个对象以采用其特定值。
不能使用此方法将类定义转换为实例,也不能将实例转换为类定义。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | wbemcli.h (包括 Wbemidl.h) |
Library | WbemUuid.lib |
DLL | CIMWin32.dll;Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll;Wbemess.dll;Wmipiprt.dll |