Metode CWbemProviderGlue::GetInstancesByQueryAsynch (wbemglue.h)

[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 GetInstancesByQueryAsynch mengambil daftar instans yang didukung oleh penyedia tertentu, dan yang cocok dengan kueri tertentu. Metode ini memungkinkan penyedia untuk merespons secara asinkron dengan mengembalikan satu instans pada satu waktu.

Sintaks

HRESULT GetInstancesByQueryAsynch(
  LPCWSTR                    query,
  Provider                   *pRequester,
  LPProviderInstanceCallback pCallback,
  LPCWSTR                    pszNamespace,
  MethodContext              *pMethodContext,
  void                       *pUserData
);

Parameter

query

Kueri yang akan dijalankan.

pRequester

Penunjuk instans kelas yang disediakan oleh penyedia kerangka kerja. Penunjuk "ini" ini diteruskan ke fungsi pCallback jika fungsi panggilan balik memerlukannya.

pCallback

Penunjuk ke fungsi statis dengan prototipe ini.

static HRESULT WINAPI Classname::FunctionName(Provider *pProvider,
                                              CInstance *pInstance,
                                              MethodContext *pMethodContext,
                                              void *pUserData );

di mana Classname adalah nama kelas yang berasal dari Penyedia kelas. Ini adalah contoh kelas ini yang merupakan penunjuk "ini" yang ditentukan oleh pRequester.

pszNamespace

Namespace untuk kueri. Jika NULL, namespace default, root\cimv2, digunakan.

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.

pUserData

Arahkan ke data yang ditentukan pengguna yang diteruskan ke fungsi yang ditunjukkan oleh pCallback. Jika NULL, tidak ada data yang ditentukan pengguna.

Mengembalikan nilai

Metode mengembalikan WBEM_S_NO_ERROR jika operasi berhasil, WBEM_E_OUT_OF_MEMORY jika operasi gagal karena kurangnya memori, atau kode kesalahan HRESULT lainnya.

Keterangan

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

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

Karena panggilan balik ke sink mungkin tidak dikembalikan pada tingkat autentikasi yang sama dengan yang dibutuhkan 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 CWbemProviderGlue::GetInstancesByQuery dan Memanggil Metode.

Persyaratan

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