Bagikan melalui


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

Lihat juga

IWbemEventConsumerProvider

IWbemUnboundObjectSink