IOleAdviseHolder::Metode saran (oleidl.h)

Membuat koneksi nasihat antara objek OLE dan sink saran objek panggilan. Melalui sink tersebut, objek panggilan dapat menerima pemberitahuan ketika objek OLE diganti namanya, disimpan, atau ditutup.

Sintaks

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

Parameter

[in] pAdvise

Penunjuk ke antarmuka IAdviseSink pada sink penasihat yang harus diberi tahu tentang perubahan.

[out] pdwConnection

Penunjuk ke token yang dapat diteruskan ke metode IOleAdviseHolder::Unadvise untuk menghapus koneksi penasihat. Objek panggilan bertanggung jawab untuk memanggil IUnknown::AddRef dan IUnknown::Release pada pointer ini.

Nilai kembali

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

Menampilkan kode	Deskripsi
E_INVALIDARG	Penunjuk antarmuka IAdviseSink yang disediakan tidak valid.

Keterangan

Kontainer, penangan objek, dan objek tautan semuanya membuat sink saran untuk menerima pemberitahuan perubahan objek dokumen majemuk yang menarik, seperti objek yang disematkan atau ditautkan. Objek OLE yang menarik bagi objek ini harus mengimplementasikan antarmuka IOleObject , yang mencakup beberapa metode penasihat, termasuk IOleObject::Advise. Panggilan ke metode ini harus menyiapkan koneksi nasihat dengan sink saran apa pun yang memanggilnya, dan mempertahankan setiap koneksi hingga ditutup. Ini harus dapat menangani lebih dari satu koneksi saran pada satu waktu.

IOleAdviseHolder::Advise dimaksudkan untuk digunakan untuk menyederhanakan implementasi IOleObject::Advise. Anda bisa mendapatkan penunjuk ke implementasi OLE IOleAdviseHolder dengan memanggil CreateOleAdviseHolder, lalu, untuk mengimplementasikan IOleObject::Advise, cukup delegasikan panggilan ke IOleAdviseHolder::Advise. Metode IOleAdviseHolder lainnya dimaksudkan untuk mengimplementasikan metode penasihat IOleObject lainnya.

Jika upaya untuk membuat koneksi penasihat berhasil, objek yang menerima panggilan mengembalikan nilai bukan nol melalui pdwConnection. Jika upaya gagal, objek mengembalikan nol. Untuk menghapus koneksi penasihat, objek dengan sink saran meneruskan token nonzero ini kembali ke objek dengan memanggil IOleAdviseHolder::Advise.

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

Lihat juga

IOleAdviseHolder

IOleAdviseHolder::EnumAdvise

IOleAdviseHolder::Unadvise

IOleObject::Advise