ClipboardObject.IDataObject.DAdvise Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualStudio.Data.Framework

Zestaw:

Microsoft.VisualStudio.Data.Framework.dll

Tworzy połączenie między obiektem schowka i ujściem poradnika. Ta metoda jest wywoływana przez obiekt, który obsługuje ujście porad i umożliwia ujście porady powiadamianie 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 ^ adviseSink, [Runtime::InteropServices::Out] int % connection) = 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 adviseSink, out int connection);

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, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer Implements IDataObject.DAdvise

Parametry

pFormatetc

FORMATETC

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

Wartość z ADVF wyliczenia, która określa grupę flag do kontrolowania połączenia doradczego.

adviseSink

IAdviseSink

Obiekt IAdviseSink wskazujący ujście porad, które otrzyma powiadomienie o zmianie.

connection

Int32

Parametr wyjściowy. Gdy ta metoda zwróci wartość , ten parametr zawiera token identyfikujący to połączenie. Tego tokenu można później użyć do usunięcia połączenia doradczego, przekazując go do elementu IDataObject.DUnadvise(Int32). Jeśli ta wartość jest równa 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: utworzono połączenie z poradami ValueDescriptionS_OKThe. E_NOTIMPLThis metoda nie jest implementowana na object.DV_E_LINDEXThere danych jest nieprawidłową wartością lindexdla ; obecnie tylko -1 jest supported.DV_E_FORMATETCThere jest nieprawidłową wartością parametru pFormatetc . OLE_E_ADVISENOTSUPPORTEDThe obiekt danych nie obsługuje powiadomienia o zmianie.

Implementuje

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)