Metode CWbemProviderGlue::GetAllDerivedInstancesAsynch (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 GetAllDerivedInstancesAsynch mengambil daftar instans yang didukung oleh penyedia tertentu dan berasal dari kelas dasar tertentu. Metode ini memungkinkan penyedia untuk merespons secara asinkron dengan mengembalikan satu instans pada satu waktu.
Sintaks
HRESULT GetAllDerivedInstancesAsynch(
LPCWSTR pszBaseClassName,
Provider *pRequester,
LPProviderInstanceCallback pCallback,
LPCWSTR pszNamespace,
MethodContext *pMethodContext,
void *pUserData
);
Parameter
pszBaseClassName
Nama kelas dasar yang daftarnya harus dikembalikan.
pRequester
Penunjuk 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 layanan nama kelas yang ditentukan oleh pszClassName. Ketika parameter ini ADALAH 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.
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 GetAllDerivedInstancesAsynch melakukan fungsi yang hampir sama dengan GetAllDerivedInstances. 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.
Metode ini secara semantik setara dengan kueri SELECT * FROM pszBaseClassName.
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. Namun, jika Anda memerlukan komunikasi asinkron, lihat Memanggil Metode.
Untuk informasi selengkapnya tentang menggunakan metode secara semisinkron, lihat CWbemProviderGlue::GetAllDerivedInstances 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 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk