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 |