Metode IWbemUnboundObjectSink::IndicateToConsumer (wbemprov.h)
Metode IWbemUnboundObjectSink::IndicateToConsumer dipanggil oleh WMI untuk benar-benar mengirimkan peristiwa kepada konsumen. Dari sudut pandang implementasi, IndicateToConsumer berisi kode untuk memproses peristiwa yang diterima sink.
Sintaks
HRESULT IndicateToConsumer(
[in] IWbemClassObject *pLogicalConsumer,
[in] long lNumObjects,
[in] IWbemClassObject **apObjects
);
Parameter
[in] pLogicalConsumer
Arahkan ke objek konsumen logis tempat kumpulan objek ini dikirimkan.
[in] lNumObjects
Jumlah objek yang dikirimkan dalam array berikut.
[in] apObjects
Penunjuk ke array instans IWbemClassObject yang mewakili peristiwa yang dikirimkan. Karena setiap objek dalam array sesuai dengan peristiwa terpisah, implementasi IndicateToConsumer harus memperlakukan setiap objek secara terpisah.
Nilai kembali
Metode ini mengembalikan WBEM_S_NO_ERROR jika berhasil. Jika tidak, implementasi harus mengembalikan kode kesalahan yang sesuai.
Keterangan
WMI biasanya mendapatkan pointer IWbemUnboundObjectSink untuk konsumen logis tertentu dari penyedia konsumen peristiwa yang mengimplementasikan antarmuka IWbemEventConsumerProvider . Kemudian, Manajemen Windows memanggil IndicateToConsumer untuk mengirimkan objek peristiwa aktual.
Sebagian besar implementasi IndicateToConsumer mengasumsikan bahwa pemberitahuan tersebut asinkron. Untuk mendukung pemberitahuan sink, sink harus menyelesaikan pemrosesan peristiwa dalam waktu kurang dari 20 milidetik. Penyedia konsumen peristiwa yang sangat cepat yang mendukung pemberitahuan sinkron tidak boleh menahan penunjuk ke antarmuka IWbemClassObject atau menaikkan jumlah referensi pointer di IndicateToConsumer. Jika IndicateToConsumer memerlukan objek kelas yang ditentukan oleh IWbemClassObject di luar masa pakai panggilan IndicateToConsumer , buat salinan objek. Namun, jika harus ada akses jangka panjang ke informasi yang ditujukan oleh pointer IWbemClassObject, disarankan agar penyedia konsumen peristiwa tidak mendukung pemberitahuan sinkron. Penyedia konsumen peristiwa menunjukkan jenis pemberitahuan yang mereka dukung ketika mereka menyelesaikan pendaftaran mereka.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | wbemprov.h (termasuk Wbemidl.h) |
| Pustaka | Wbemuuid.lib |
| DLL | Fastprox.dll |