ClipboardObject.IDataObject.DAdvise Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vytvoří propojení mezi objektem schránky a jímkou poradce. Tato metoda je volána objektem, který podporuje poradní jímku a umožňuje, aby jímka poradce byla informována o změnách v datech objektu.
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 předaná odkazem, která definuje formát, cílové zařízení, aspekt a médium, které se budou používat pro budoucí oznámení.
- adviseSink
- IAdviseSink
Objekt IAdviseSink odkazující na jímku poradce, který obdrží oznámení o změně.
- connection
- Int32
Out parametr. Když tato metoda vrátí, tento parametr obsahuje token, který identifikuje toto připojení. Tento token můžete později použít k odstranění připojení poradce tak, že ho předáte do IDataObject.DUnadvise(Int32). Pokud je tato hodnota nula, připojení nebylo navázáno. Tento parametr se předává neinicializovaný.
Návraty
Tato metoda podporuje standardní návratové hodnoty E_INVALIDARG, E_UNEXPECTED a E_OUTOFMEMORY a také následující: ValueDescriptionS_OKThe bylo vytvořeno připojení poradce. E_NOTIMPLThis metoda není implementována v datovém object.DV_E_LINDEXThere je neplatná hodnota pro lindex; v současné době je pouze -1 supported.DV_E_FORMATETCThere je neplatná hodnota parametru pFormatetc
. OLE_E_ADVISENOTSUPPORTEDThe datový objekt nepodporuje oznámení o změnách.