ClipboardObject.IDataObject.DAdvise Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> intFunction DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer Implements IDataObject.DAdviseParametry
- 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
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.