Bagikan melalui


DataObject.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 penasihat untuk diberi tahu tentang perubahan dalam data objek.

 virtual int System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise(System::Runtime::InteropServices::ComTypes::FORMATETC % pFormatetc, System::Runtime::InteropServices::ComTypes::ADVF advf, System::Runtime::InteropServices::ComTypes::IAdviseSink ^ pAdvSink, [Runtime::InteropServices::Out] int % pdwConnection) = System::Runtime::InteropServices::ComTypes::IDataObject::DAdvise;
int IDataObject.DAdvise (ref System.Runtime.InteropServices.ComTypes.FORMATETC pFormatetc, System.Runtime.InteropServices.ComTypes.ADVF advf, System.Runtime.InteropServices.ComTypes.IAdviseSink pAdvSink, out int pdwConnection);
abstract member System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int
override this.System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int
Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, pAdvSink As IAdviseSink, ByRef pdwConnection As Integer) As Integer Implements IDataObject.DAdvise

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.

pAdvSink
IAdviseSink

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

pdwConnection
Int32

Ketika metode ini kembali, berisi pointer 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.

Penerapan

Keterangan

Anggota ini adalah implementasi anggota antarmuka eksplisit. Ini hanya dapat digunakan ketika dilemparkan DataObject ke IDataObject antarmuka.

Berlaku untuk