Metode IEnumWbemClassObject::Clone (wbemcli.h)

Metode IEnumWbemClassObject::Clone membuat salinan logis dari seluruh enumerator, mempertahankan posisinya saat ini dalam enumerasi. Metode ini hanya membuat salinan "upaya terbaik". Karena berbagai objek CIM bersifat dinamis, ada kemungkinan bahwa enumerator baru tidak menghitung rangkaian objek yang sama dengan enumerator sumber.

Catatan  

Ketika enumerasi diinisialisasi dengan bendera WBEM_FLAG_FORWARD_ONLY , IEnumWbemClassObject::Clone tidak didukung.

Setiap pengiriman asinkron yang tertunda yang dimulai oleh NextAsync tidak dikloning.

 

Sintaks

HRESULT Clone(
  [out] IEnumWbemClassObject **ppEnum
);

Parameter

[out] ppEnum

Menerima pointer ke objek IEnumWbemClassObject baru. Pemanggil harus memanggil Rilis ketika penunjuk antarmuka tidak lagi diperlukan. Jika terjadi kesalahan, tidak akan ada pengembalian objek baru.

Mengembalikan nilai

Jika terjadi kesalahan, Anda dapat memanggil fungsi COM GetErrorInfo untuk mendapatkan informasi kesalahan lebih lanjut. Kode kesalahan khusus COM juga dapat dikembalikan jika masalah jaringan menyebabkan Anda kehilangan koneksi jarak jauh ke Manajemen Windows.

Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT.

Keterangan

Karena panggilan balik ke sink mungkin tidak dikembalikan pada tingkat autentikasi yang sama dengan yang diperlukan klien, disarankan agar Anda menggunakan komunikasi semisinkron alih-alih asinkron. Jika Anda memerlukan komunikasi asinkron, lihat Memanggil Metode.

Untuk informasi selengkapnya tentang menggunakan metode secara semisinkron, lihat IEnumWbemClassObject dan Memanggil Metode.

Contoh

Kode berikut menunjukkan cara menggunakan metode IEnumWbemClassObject::Clone .

BOOL CloneEnum(IEnumWbemClassObject *pSrc)
{
    IEnumWbemClassObject *pCopy = 0;

    HRESULT hRes = pSrc->Clone(&pCopy);

    if (hRes != WBEM_S_NO_ERROR)       // Failed to clone it.
        return FALSE;

    // Use the copy of the enumerator.
    // ...

    pCopy->Release();

    return TRUE;
}

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	Fastprox.dll