CWbemProviderGlue::GetInstancesByQuery (wbemglue.h)

Artikel
03/13/2024

[Kelas CWbemProviderGlue adalah bagian dari Kerangka Kerja Penyedia WMI yang sekarang dipertimbangkan dalam keadaan akhir, dan tidak ada pengembangan, peningkatan, atau pembaruan lebih lanjut yang akan tersedia untuk masalah terkait non-keamanan yang memengaruhi pustaka ini. API MI harus digunakan untuk semua pengembangan baru.]

Metode GetInstancesByQuery mengambil daftar instans yang cocok dengan kueri tertentu.

Sintaks

HRESULT GetInstancesByQuery(
  LPCWSTR                          query,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

Parameter

query

Kueri yang akan dijalankan.

pList

Daftar instans tertaut yang cocok dengan kueri yang ditentukan oleh Kueri.

pMethodContext

Arahkan ke konteks saat ini. Konteks harus disediakan untuk mencegah kebuntuan. Gunakan konteks yang diteruskan ke penyedia oleh Penyedia::EnumerateInstances atau Provider::ExecQuery, atau dapatkan dari instans menggunakan CInstance::GetMethodContext. Parameter ini tidak boleh NULL.

pszNamespace

Arahkan ke namespace layanan yang berisi instans. Jika NULL, namespace default, root\cimv2, digunakan.

Nilai kembali

Metode mengembalikan WBEM_S_NO_ERROR jika operasi berhasil, WBEM_E_FAILED jika operasi gagal, atau kode kesalahan HRESULT lainnya.

Keterangan

Metode GetInstancesByQuery memungkinkan penyedia kerangka kerja untuk mengakses data dari penyedia lain tanpa harus melakukan panggilan API WMI. Penyedia kerangka kerja meneruskan kueri ke GetInstancesByQuery, yang mengembalikan instans yang sesuai.

Untuk alasan performa, saat memanggil fungsi ini, tentukan hanya properti yang Anda butuhkan (misalnya, tentukan " SELECT name" alih-alih "SELECT *").

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemglue.h (termasuk FwCommon.h)
Pustaka	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll

Share via