Fungsi CloneEnumWbemClassObject

Membuat salinan logis enumerator, mempertahankan posisinya saat ini dalam enumerasi.

Catatan

API ini hanya untuk penggunaan internal. API ini tidak dimaksudkan untuk digunakan dari kode pengembang.

Sintaks

HRESULT CloneEnumWbemClassObject (
   [out] IEnumWbemClassObject**  ppEnum,
   [in] DWORD                    authLevel,
   [in] DWORD                    impLevel,
   [in] IEnumWbemClassObject*    pCurrentEnumWbemClassObject,
   [in] BSTR                     strUser,
   [in] BSTR                     strPassword,
   [in BSTR]                     strAuthority
);

Parameter

ppEnum
[out] Menerima penunjuk ke IEnumWbemClassObject baru.

authLevel
[in] Tingkat otorisasi.

impLevel
[in] Tingkat peniruan.

pCurrentEnumWbemClassObject
[out] Penunjuk ke instans IEnumWbemClassObject yang akan di-klon.

strUser
[in] Nama pengguna. Lihat fungsi ConnectServerWmi untuk informasi selengkapnya.

strPassword
[in] Kata sandi. Lihat fungsi ConnectServerWmi untuk informasi selengkapnya.

strAuthority
[in] Nama domain pengguna. Lihat fungsi ConnectServerWmi untuk informasi selengkapnya.

Mengembalikan nilai

Nilai berikut yang dikembalikan oleh fungsi ini ditentukan dalam file header WbemCli.h, atau Anda dapat menentukannya sebagai konstanta dalam kode Anda:

Terus-menerus	Nilai	Deskripsi
WBEM_E_FAILED	0x80041001	Terjadi kegagalan umum.
WBEM_E_INVALID_PARAMETER	0x80041008	Parameter tidak valid.
WBEM_E_OUT_OF_MEMORY	0x80041006	Memori tidak cukup untuk menyelesaikan operasi.
WBEM_E_TRANSPORT_FAILURE	0x80041015	Tautan panggilan prosedur jarak jauh (RPC) antara proses saat ini dan WMI telah gagal.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Keterangan

Fungsi ini membungkus panggilan ke metode IEnumWbemClassObject::Clone.

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.

Jika panggilan fungsi gagal, Anda bisa mendapatkan informasi kesalahan tambahan dengan memanggil fungsi GetErrorInfo.

Contoh

Misalnya, lihat metode IEnumWbemClassObject::Clone.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: WMINet_Utils.idl

Versi .NET Framework: Tersedia sejak 4.7.2

Lihat juga

• WMI dan Penghitung Kinerja (Referensi API Tidak Terkelola)