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