Bagikan melalui


IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Metode

Definisi

Membuat koneksi antara objek data dan sink penasihat. Metode ini dipanggil oleh objek yang mendukung sink penasihat dan memungkinkan sink saran untuk diberi tahu tentang perubahan dalam data objek.

public:
 int DAdvise(System::Runtime::InteropServices::ComTypes::FORMATETC % pFormatetc, System::Runtime::InteropServices::ComTypes::ADVF advf, System::Runtime::InteropServices::ComTypes::IAdviseSink ^ adviseSink, [Runtime::InteropServices::Out] int % connection);
public int DAdvise (ref System.Runtime.InteropServices.ComTypes.FORMATETC pFormatetc, System.Runtime.InteropServices.ComTypes.ADVF advf, System.Runtime.InteropServices.ComTypes.IAdviseSink adviseSink, out int connection);
abstract member DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int
Public Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer

Parameter

pFormatetc
FORMATETC

Struktur FORMATETC , diteruskan oleh referensi, yang menentukan format, perangkat target, aspek, dan media yang akan digunakan untuk pemberitahuan di masa mendatang.

advf
ADVF

Salah ADVF satu nilai yang menentukan sekelompok bendera untuk mengontrol koneksi penasihat.

adviseSink
IAdviseSink

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

connection
Int32

Ketika metode ini kembali, berisi penunjuk ke token DWORD yang mengidentifikasi koneksi ini. Anda dapat menggunakan token ini nanti untuk menghapus koneksi penasihat dengan meneruskannya ke DUnadvise(Int32). Jika nilai ini nol, koneksi tidak dibuat. Parameter ini diteruskan tanpa diinisialisasi.

Mengembalikan

Metode ini mendukung nilai pengembalian standar E_INVALIDARG, E_UNEXPECTED, dan E_OUTOFMEMORY, serta berikut ini:

Nilai Deskripsi
S_OK Koneksi penasihat dibuat.
E_NOTIMPL Metode ini tidak diimplementasikan pada objek data.
DV_E_LINDEX Ada nilai yang tidak valid untuk lindex; saat ini, hanya -1 yang didukung.
DV_E_FORMATETC Ada nilai yang tidak valid untuk pFormatetc parameter .
OLE_E_ADVISENOTSUPPORTED Objek data tidak mendukung pemberitahuan perubahan.

Keterangan

Untuk informasi selengkapnya, lihat metode IDataObject::D Advise.

Berlaku untuk