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

Referensi

Definisi

Ruang nama:: System.Runtime.InteropServices.ComTypes

Rakitan:: System.Runtime.InteropServices.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

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 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

Int32

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

Share via