Bagikan melalui


Metode IWbemClassObject::Clone (wbemcli.h)

Metode IWbemClassObject::Clone mengembalikan objek baru yang merupakan klon lengkap dari objek saat ini. Objek baru memiliki jumlah referensi COM 1.

Sintaks

HRESULT Clone(
  [out] IWbemClassObject **ppCopy
);

Parameter

[out] ppCopy

Parameter ini tidak boleh NULL. Ini menerima salinan objek saat ini. Anda harus memanggil IWbemClassObject::Release pada objek ini ketika tidak lagi diperlukan.

Objek baru tidak dikembalikan pada kesalahan.

Nilai kembali

Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.

Keterangan

Gunakan metode ini untuk menduplikasi definisi kelas, atau untuk menduplikasi instans. Ini dapat berguna ketika salinan asli objek diperlukan untuk tujuan pencadangan saat salinan baru dimodifikasi. Demikian juga, gunakan metode ini untuk membuat banyak instans baru dari satu instans sumber. Misalnya, gunakan IWbemClassObject::SpawnInstance untuk membuat satu instans awal, dan gunakan IWbemClassObject::Clone untuk menghasilkan 100 salinan instans dengan cepat. Setiap objek kemudian dapat dimodifikasi untuk mengambil nilai tertentu.

Tidak dimungkinkan untuk menggunakan metode ini untuk mengonversi definisi kelas menjadi instans, atau mengonversi instans menjadi definisi kelas.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista
Server minimum yang didukung Windows Server 2008
Target Platform Windows
Header wbemcli.h (termasuk Wbemidl.h)
Pustaka WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll