IDataAdviseHolder::Metode saran (objidl.h)

Artikel
02/29/2024

Membuat koneksi antara sink saran dan objek data untuk menerima pemberitahuan.

Sintaks

HRESULT Advise(
  [in]  IDataObject *pDataObject,
  [in]  FORMATETC   *pFetc,
  [in]  DWORD       advf,
  [in]  IAdviseSink *pAdvise,
  [out] DWORD       *pdwConnection
);

Parameter

[in] pDataObject

Penunjuk ke antarmuka IDataObject pada objek data yang pemberitahuannya diminta. Jika data dalam objek ini berubah, pemberitahuan dikirim ke sink saran yang telah meminta pemberitahuan.

[in] pFetc

Penunjuk ke struktur FORMATETC yang berisi format, sedang, dan perangkat target yang ditentukan yang menarik bagi sink saran yang meminta pemberitahuan. Misalnya, satu sink mungkin ingin tahu hanya ketika representasi bitmap data dalam objek data berubah. Sink lain mungkin hanya tertarik pada format metafile dari objek yang sama. Setiap sink saran diberi tahu ketika data minat berubah. Data ini diteruskan kembali ke sink saran saat pemberitahuan terjadi.

[in] advf

Sekelompok bendera yang mengontrol koneksi penasihat. Nilai yang mungkin berasal dari enumerasi ADVF . Namun, hanya beberapa nilai ADVF yang mungkin relevan untuk metode ini. Tabel berikut ini menjelaskan secara singkat nilai yang relevan; deskripsi yang lebih rinci dapat ditemukan dalam deskripsi enumerasi ADVF .

Nilai	Makna
ADVF_NODATA	Meminta agar tidak ada data yang dikirim bersama dengan pemberitahuan.
ADVF_ONLYONCE	Menyebabkan koneksi penasihat dihancurkan setelah pemberitahuan pertama dikirim. Panggilan implisit ke IDataAdviseHolder::Unadvise dilakukan atas nama penelepon untuk menghapus koneksi.
ADVF_PRIMEFIRST	Menyebabkan pemberitahuan awal dikirim terlepas dari apakah data telah berubah dari statusnya saat ini.
ADVF_DATAONSTOP	Ketika ditentukan dengan ADVF_NODATA, bendera ini menyebabkan pemberitahuan terakhir dengan data yang disertakan dikirim sebelum objek data dihancurkan. Ketika ADVF_NODATA tidak ditentukan, bendera ini tidak berpengaruh.

[in] pAdvise

Penunjuk ke antarmuka IAdviseSink pada sink penasihat yang menerima pemberitahuan perubahan.

[out] pdwConnection

Penunjuk ke variabel yang menerima token yang mengidentifikasi koneksi ini. Objek panggilan nantinya dapat menghapus koneksi penasihat dengan meneruskan token ini ke IDataAdviseHolder::Unadvise. Jika nilai ini nol, koneksi tidak dibuat.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan.

Keterangan

Melalui koneksi yang dibuat melalui metode ini, sink penasihat dapat menerima pemberitahuan di masa mendatang dalam panggilan ke IAdviseSink::OnDataChange.

Objek mengeluarkan panggilan ke IDataObject::D Advise untuk meminta pemberitahuan tentang perubahan pada format, sedang, atau perangkat target yang menarik. Data ini ditentukan dalam parameter pFormatetc . Metode DAdvise biasanya diimplementasikan untuk memanggil IDataAdviseHolder::Advise untuk mendelegasikan tugas menyiapkan dan melacak koneksi ke pemegang saran. Saat perangkat format, sedang, atau target yang dimaksud berubah, objek data memanggil IDataAdviseHolder::SendOnDataChange untuk mengirim pemberitahuan yang diperlukan.

Koneksi yang dibuat dapat dihapus dengan meneruskan nilai dalam pdwConnection dalam panggilan ke IDataAdviseHolder::Unadvise.

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	objidl.h

Lihat juga

CreateDataAdviseHolder

IDataAdviseHolder

IDataObject::D Advise

Bagikan melalui