Metode IDataAdviseHolder::SendOnDataChange (objidl.h)

Mengirim pemberitahuan ke setiap sink saran yang koneksinya dibuat dengan memanggil metode IAdviseSink::OnDataChange untuk setiap sink saran yang saat ini sedang ditangani oleh instans objek pemegang saran ini.

Sintaks

HRESULT SendOnDataChange(
  [in] IDataObject *pDataObject,
  [in] DWORD       dwReserved,
  [in] DWORD       advf
);

Parameter

[in] pDataObject

Penunjuk ke antarmuka IDataObject pada objek data tempat data baru saja berubah. Pointer ini digunakan dalam panggilan berikutnya ke IAdviseSink::OnDataChange.

[in] dwReserved

Parameter ini dicadangkan dan harus 0.

[in] advf

Kontainer untuk bendera saran yang menentukan bagaimana panggilan ke IAdviseSink::OnDataChange dibuat. Nilai bendera ini berasal dari ADVF enumerasi. Biasanya, nilai untuk advf adalah NULL. Satu-satunya pengecualian terjadi ketika objek data dimatikan dan harus mengirim pemberitahuan akhir yang menyertakan data aktual ke sink yang telah ditentukan ADVF_DATAONSTOP dan ADVF_NODATA dalam panggilan mereka ke IDataObject::D Advise. Dalam hal ini, advf berisi ADVF_DATAONSTOP.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan.

Keterangan

Objek data harus memanggil metode ini ketika mendeteksi perubahan yang akan menarik bagi sink saran yang sebelumnya telah meminta pemberitahuan.

Sebagian besar pemberitahuan mencakup data aktual dengannya. Satu-satunya pengecualian adalah jika bendera ADVF_NODATA sebelumnya ditentukan ketika koneksi awalnya disiapkan dalam metode IDataAdviseHolder::Advise .

Sebelum memanggil metode IAdviseSink::OnDataChange untuk setiap sink saran, metode ini mendapatkan data aktual dengan memanggil metode IDataObject::GetData melalui penunjuk yang ditentukan dalam parameter pDataObject .

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

IAdviseSink::OnDataChange

IDataAdviseHolder