DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Tworzy połączenie między obiektem danych a ujściem porad. Ta metoda jest wywoływana przez obiekt, który obsługuje ujście porad i umożliwia ujściu porad powiadomienia o zmianach w danych obiektu.

 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

Parametry

pFormatetc

FORMATETC

FORMATETC Struktura przekazywana przez odwołanie, która definiuje format, urządzenie docelowe, aspekt i medium, które będą używane na potrzeby przyszłych powiadomień.

advf

ADVF

ADVF Jedna z wartości określających grupę flag do kontrolowania połączenia doradczego.

pAdvSink

IAdviseSink

Wskaźnik do interfejsu IAdviseSink ujścia porad, który otrzyma powiadomienie o zmianie.

pdwConnection

Int32

Gdy ta metoda zostanie zwrócona, zawiera wskaźnik do tokenu DWORD, który identyfikuje to połączenie. Możesz później użyć tego tokenu, aby usunąć połączenie z poradami, przekazując je do DUnadvise(Int32)usługi . Jeśli ta wartość ma wartość zero, połączenie nie zostało nawiązane. Ten parametr jest przekazywany jako niezainicjowany.

Zwraca

Int32

Ta metoda obsługuje standardowe wartości zwracane E_INVALIDARG, E_UNEXPECTED i E_OUTOFMEMORY, a także następujące:

Wartość	Opis
S_OK	Utworzono połączenie z poradami.
E_NOTIMPL	Ta metoda nie jest implementowana w obiekcie danych.
DV_E_LINDEX	Dla parametru jest nieprawidłowa wartość lindex; obecnie obsługiwana jest tylko wartość -1.
DV_E_FORMATETC	Dla parametru istnieje nieprawidłowa pFormatetc wartość.
OLE_E_ADVISENOTSUPPORTED	Obiekt danych nie obsługuje powiadomienia o zmianie.

Implementuje

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Uwagi

Ten element jest jawną implementacją członków. Można go używać tylko wtedy, gdy DataObject element jest rzutowy do interfejsu IDataObject .