共用方式為


IWbemClassObject::Clone 方法 (wbemcli.h)

IWbemClassObject::Clone 方法會傳回新物件,這是目前物件的完整複本。 新的物件具有 1 的 COM 參考計數。

語法

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)
程式庫 WbemUuid.lib
Dll CIMWin32.dll;Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll;Wbemess.dll;Wmipiprt.dll