Metode IWbemClassObject::Clone (wbemcli.h)

Artikel
03/03/2024

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

Bagikan melalui