Antarmuka IAdviseSink (objidl.h)

Artikel
08/25/2023

Memungkinkan kontainer dan objek lain untuk menerima pemberitahuan perubahan data, melihat perubahan, dan perubahan dokumen campuran yang terjadi pada objek yang diminati. Aplikasi kontainer, misalnya, mengharuskan pemberitahuan tersebut untuk menjaga presentasi cache objek yang ditautkan dan disematkan tetap terbaru. Panggilan ke metode IAdviseSink tidak sinkron, sehingga panggilan dikirim dan kemudian instruksi berikutnya dijalankan tanpa menunggu pengembalian panggilan.

Agar koneksi penasihat ada, objek yang menerima pemberitahuan harus mengimplementasikan IAdviseSink, dan objek yang diminatinya harus mengimplementasikan IOleObject::Advise dan IDataObject::D Advise. Objek dan handler dalam proses juga dapat mengimplementasikan IViewObject::SetAdvise. Objek yang mengimplementasikan IOleObject harus mendukung semua metode penasihat yang wajar. Untuk menyederhanakan pemberitahuan saran, OLE menyediakan implementasi IDataAdviseHolder dan IOleAdviseHolder, yang melacak koneksi saran dan mengirim pemberitahuan ke sink yang tepat melalui pointer ke antarmuka IAdviseSink mereka. IViewObject (dan metode penasihatnya) diimplementasikan dalam handler default.

Seperti yang ditunjukkan dalam tabel berikut, objek yang telah menerapkan sink saran mendaftarkan minatnya untuk menerima jenis pemberitahuan tertentu dengan memanggil metode yang sesuai.

Panggil Metode Ini	Untuk Mendaftar pemberitahuan ini
IOleObject::Advise	Saat dokumen disimpan, ditutup, atau diganti namanya.
IDataObject::D Advise	Saat data dokumen berubah.
IViewObject::SetAdvise	Saat presentasi dokumen berubah.

Ketika peristiwa terjadi yang berlaku untuk jenis pemberitahuan terdaftar, aplikasi objek memanggil metode IAdviseSink yang sesuai. Misalnya, ketika objek yang disematkan ditutup, objek memanggil metode IAdviseSink::OnClose untuk memberi tahu kontainernya. Pemberitahuan ini tidak sinkron, terjadi setelah peristiwa yang memicunya.

Warisan

Antarmuka IAdviseSink mewarisi dari antarmuka IUnknown . IAdviseSink juga memiliki jenis anggota ini:

Metode

Antarmuka IAdviseSink memiliki metode ini.


IAdviseSink::Onclose Dipanggil oleh server untuk memberi tahu semua sink penasihat terdaftar bahwa objek telah berubah dari yang sedang berjalan ke status dimuat.
IAdviseSink::OnDataChange Dipanggil oleh server untuk memberi tahu objek data yang saat ini terdaftar menyarankan sink bahwa data dalam objek telah berubah.
IAdviseSink::OnRename Dipanggil oleh server untuk memberi tahu semua sink penasihat terdaftar bahwa objek telah diganti namanya.
IAdviseSink::OnSave Dipanggil oleh server untuk memberi tahu semua sink saran terdaftar bahwa objek telah disimpan.
IAdviseSink::OnViewChange Memberi tahu sink saran terdaftar objek bahwa tampilannya telah berubah.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	objidl.h