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