IWbemObjectSink::Menunjukkan metode (wbemcli.h)

Artikel
03/08/2023

Metode Menunjukkan dipanggil oleh sumber untuk memberikan pemberitahuan. Biasanya, WMI memanggil implementasi klien antarmuka ini setelah klien menjalankan salah satu metode asinkron IWbemServices. Dalam kasus lain, berbagai jenis penyedia memanggil implementasi yang diekspor oleh WMI untuk mengirimkan peristiwa. Oleh karena itu, kode klien mungkin harus menerapkan antarmuka ini dalam beberapa kasus, dan menggunakan implementasi komponen yang berbeda dalam kasus lain.

Gunakan antarmuka dan metode ini bersama dengan metode asinkron antarmuka IWbemServices .

Klien dan penyedia harus menerapkan antarmuka ini untuk menerima pemberitahuan atau untuk menjalankan metode asinkron IWbemServices. Untuk informasi selengkapnya, lihat Memanggil Metode.

Sintaks

HRESULT Indicate(
  [in] long             lObjectCount,
  [in] IWbemClassObject **apObjArray
);

Parameter

[in] lObjectCount

Jumlah objek dalam array pointer berikut.

[in] apObjArray

Array pointer ke antarmuka IWbemClassObject . Memori array itu sendiri bersifat baca-saja, dan dimiliki oleh pemanggil metode . Karena ini adalah parameter , implementasi memiliki opsi untuk memanggil IWbemClassObject::AddRef pada penunjuk objek apa pun dalam array dan menahannya sebelum mengembalikan jika objek akan digunakan setelah metode dikembalikan, sesuai dengan aturan COM. Jika objek hanya digunakan selama durasi panggilan Tunjukkan , maka Anda tidak perlu memanggil AddRef pada setiap penunjuk objek.

Mengembalikan nilai

Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT.

Keterangan

Saat menerapkan sink langganan peristiwa (IWbemObjectSink atau IWbemEventSink), jangan memanggil WMI dari dalam metode Tunjukkan pada objek sink. Misalnya, memanggil IWbemServices::CancelAsyncCall dari dalam implementasi Menunjukkan dapat mengganggu status WMI. Untuk membatalkan langganan acara, atur bendera dan panggil IWbemServices::CancelAsyncCall dari utas atau objek lain. Untuk implementasi yang tidak terkait dengan sink peristiwa, seperti pengambilan objek, enum, dan kueri, Anda dapat memanggil kembali ke WMI.

Implementasi sink harus memproses pemberitahuan peristiwa dalam 100 MSEC karena utas WMI yang mengirimkan pemberitahuan peristiwa tidak dapat melakukan pekerjaan lain sampai objek sink selesai diproses. Jika pemberitahuan memerlukan pemrosesan dalam jumlah besar, sink dapat menggunakan antrean internal untuk utas lain untuk menangani pemrosesan.

Saat penyedia peristiwa memanggil Menunjukkan untuk menyediakan peristiwa, panggilan dapat gagal dengan WBEM_E_SERVER_TOO_BUSY. Penyedia dapat memilih untuk menanggapi pesan ini dengan mengaktifkan kembali peristiwa.

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.

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemcli.h (termasuk Wbemidl.h)
Pustaka	Wbemuuid.lib
DLL	Fastprox.dll

Lihat juga

IWbemObjectSink

IWbemObjectSink::SetStatus

IWbemObjectSinkEx

IWbemServices::ExecQueryAsync

Bagikan melalui