IWSManSession::Enumerate method (wsmandisp.h)

  • Artikel

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

Lihat juga

IWSManEnumerator

IWSManSession

Session.Enumerate