IOleObject::Metode saran (oleidl.h)

Artikel
03/01/2024

Membuat koneksi nasihat antara objek dokumen campuran dan sink saran objek panggilan, di mana objek panggilan menerima pemberitahuan ketika objek dokumen gabungan diganti namanya, disimpan, atau ditutup.

Sintaks

HRESULT Advise(
  [in]  IAdviseSink *pAdvSink,
  [out] DWORD       *pdwConnection
);

Parameter

[in] pAdvSink

Arahkan ke antarmuka IAdviseSink pada sink saran objek panggilan.

[out] pdwConnection

Penunjuk ke token yang dapat diteruskan ke IOleObject::Unadvise untuk menghapus koneksi penasihat.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Tidak tersedia cukup memori untuk operasi ini.

Keterangan

Metode IOleObject::Advise menyiapkan koneksi saran antara objek dan kontainernya, di mana objek menginformasikan sink saran kontainer untuk menutup, menyimpan, mengganti nama, dan peristiwa perubahan sumber tautan dalam objek. Kontainer memanggil metode ini, biasanya sebagai bagian dari menginisialisasi objek, untuk mendaftarkan sink penasihatnya dengan objek . Sebagai gantinya, objek mengirim pemberitahuan kontainer compound-document dengan memanggil IAdviseSink atau IAdviseSink2.

Jika kontainer dan objek berhasil membuat koneksi penasihat, objek yang menerima panggilan mengembalikan nilai bukan nol melalui pdwConnection ke kontainer. Jika upaya untuk membuat koneksi penasihat gagal, objek mengembalikan nol. Untuk menghapus koneksi penasihat, kontainer memanggil IOleObject::Unadvise dan meneruskan token bukan nol ini kembali ke objek.

Objek dapat mendelegasikan pekerjaan pengelolaan dan pelacakan peristiwa saran kepada pemegang saran OLE, tempat Anda mendapatkan pointer dengan memanggil CreateOleAdviseHolder. Antarmuka IOleAdviseHolder yang dikembalikan memiliki tiga metode untuk mengirim pemberitahuan saran, serta metode IOleAdviseHolder::Advise, IOleAdviseHolder::Unadvise, dan IOleAdviseHolder::EnumAdvise yang identik dengan metode untuk IOleObject. Panggilan ke IOleObject::Advise, IOleObject::Unadvise, atau IOleObject::EnumAdvise didelegasikan ke metode yang sesuai di pemegang saran.

Untuk menghancurkan pemegang saran, cukup panggil IUnknown::Release pada antarmuka IOleAdviseHolder .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	oleidl.h