Metode CWbemProviderGlue::GetAllInstancesAsynch (wbemglue.h)

Artikel
03/09/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 GetAllInstancesAsynch mengambil daftar instans yang dikembalikan oleh kelas tertentu. Metode ini memungkinkan penyedia untuk merespons secara asinkron dengan mengembalikan satu instans sekaligus.

Sintaks

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

Parameter

pszClassName

Nama kelas yang daftar instansnya harus dikembalikan.

pRequester

Penunjuk "Ini" untuk fungsi panggilan balik yang ditunjukkan oleh pCallback.

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. Fungsi ini dipanggil untuk mengembalikan setiap instans yang didukung oleh penyedia yang ditentukan oleh pszClassName.

pszNamespace

Namespace penyedia yang ditentukan oleh pszClassName. Parameter ini dapat berupa NULL untuk menunjukkan namespace default, yaitu root\cimv2.

pMethodContext

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

pUserData

Penunjuk ke data yang ditentukan pengguna yang diteruskan ke fungsi yang ditunjukkan oleh pCallback.

Nilai kembali

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 GetAllInstancesAsynch melakukan fungsi yang hampir sama dengan GetAllInstances. Namun, alih-alih mengembalikan satu array instans yang sangat besar, penyedia meneruskan instans ke fungsi yang ditentukan oleh pCallback setiap kali instans diambil dari penyedia. Ini memungkinkan penyedia untuk menggunakan lebih sedikit memori, dan untuk mulai mengembalikan instans ke klien lebih cepat.

Catatan Karena panggilan balik ke sink mungkin tidak dikembalikan pada tingkat autentikasi yang sama dengan yang diperlukan klien, disarankan agar Anda menggunakan semisinkron alih-alih komunikasi asinkron. Untuk informasi selengkapnya, lihat Memanggil Metode.

Metode ini secara semantik setara dengan kueri SELECT * FROM pszBaseClassName WHERE __Class = pszBaseClassName.

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