DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.