IWSManSession::Enumerate method (wsmandisp.h)
Menghitung tabel, pengumpulan data, atau sumber daya log. Untuk membuat kueri, sertakan parameter filter dan parameter dialek dalam enumerasi. Anda juga dapat menggunakan objek IWSManResourceLocator untuk membuat kueri. Untuk informasi selengkapnya, lihat Menghitung atau Mencantumkan Semua Instans Sumber Daya.
Sintaks
HRESULT Enumerate(
[in] VARIANT resourceUri,
[in, optional] BSTR filter,
[in, optional] BSTR dialect,
[in] long flags,
[out] IDispatch **resultSet
);
Parameter
[in] resourceUri
Pengidentifikasi sumber daya yang akan diambil.
Daftar berikut berisi pengidentifikasi yang dapat berisi parameter ini:
- URI dengan satu atau beberapa pemilih. Saat memanggil metode Enumerate untuk mendapatkan sumber daya WMI, gunakan properti kunci atau properti objek.
- Anda dapat menggunakan pemilih, fragmen, atau opsi. Untuk informasi selengkapnya, lihat IWSManResourceLocator.
- Referensi titik akhir WS-Addressing seperti yang dijelaskan dalam standar protokol WS-Management. Untuk informasi selengkapnya tentang spesifikasi publik untuk protokol WS-Management, lihat Halaman Indeks Spesifikasi Manajemen.
[in, optional] filter
Filter yang menentukan item apa dalam sumber daya yang dikembalikan oleh enumerasi. Saat sumber daya dijumlahkan, hanya item yang cocok dengan kriteria filter yang dikembalikan. Menyertakan parameter filter dan parameter dialek dalam enumerasi mengonversi enumerasi menjadi kueri.
Jika Anda memiliki objek IWSManResourceLocator untuk parameter resourceURI , parameter ini tidak boleh digunakan. Sebagai gantinya, gunakan fungsi pemilih dan fragmen IWSManResourceLocator.
[in, optional] dialect
Bahasa yang digunakan oleh filter. WQL, subset SQL yang digunakan oleh WMI, adalah satu-satunya bahasa yang didukung.
Jika Anda memiliki objek IWSManResourceLocator untuk parameter resourceURI , parameter ini tidak boleh digunakan. Sebagai gantinya, gunakan fungsi pemilih dan fragmen IWSManResourceLocator.
[in] flags
Parameter ini harus berisi bendera dalam enumerasi __WSManEnumFlags . Untuk informasi selengkapnya, lihat Konstanta Enumerasi.
[out] resultSet
Objek IWSManEnumerator yang berisi hasil enumerasi.
Mengembalikan nilai
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Panggil IWSManSession::Enumerate untuk memulai operasi enumerasi. Setelah itu, panggil IWSManEnumerator::ReadItem menggunakan objek IWSManEnumerator yang dikembalikan hingga akhir item ditunjukkan oleh properti AtEndOfStream .
Ketahuilah bahwa jika bendera menyertakan Enumeration ConstantsWSManFlagHierarchyDeepBasePropsOnly atau WSManFlagHierarchyShallow , maka layanan Manajemen Jarak Jauh Windows mengembalikan kode kesalahan ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED.
Untuk informasi selengkapnya tentang membatasi panggilan jaringan selama enumerasi, lihat properti BatchItems .
Jika filter ditentukan, filter harus berupa dokumen yang valid sehubungan dengan skema sumber daya. Parameter dialek bersifat opsional. Namun, jika string filter dimulai dengan <, tetapi bukan fragmen XML, maka sertakan parameter dialek atau atur bendera WSManFlagNonXmlText di parameter bendera . Untuk informasi selengkapnya, lihat Konstanta Enumerasi.
Metode pembuatan skrip yang sesuai adalah Session.Enumerate.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista |
Server minimum yang didukung | Windows Server 2008 |
Target Platform | Windows |
Header | wsmandisp.h |
Pustaka | WSManDisp.tlb |
DLL | WSMAuto.dll |