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

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataObject.cs

Vytvoří propojení mezi datovým objektem a jímkou rady. Tato metoda je volána objektem, který podporuje jímku poradenství a umožňuje jímce rady dostávat oznámení 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 ^ 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

Struktura FORMATETC předaná odkazem, která definuje formát, cílové zařízení, aspekt a médium, které se použijí pro budoucí oznámení.

advf

ADVF

Jedna z ADVF hodnot, která určuje skupinu příznaků pro řízení připojení rady.

pAdvSink

IAdviseSink

Ukazatel na IAdviseSink rozhraní v jímce rady, který obdrží oznámení o změně.

pdwConnection

Int32

Pokud tato metoda vrátí, obsahuje ukazatel na token DWORD, který identifikuje toto připojení. Tento token můžete později použít k odstranění připojení poradce předáním DUnadvise(Int32). Pokud je tato hodnota nula, připojení nebylo vytvořeno. Tento parametr se předává neinicializovaný.

Návraty

Int32

Tato metoda podporuje standardní návratové hodnoty E_INVALIDARG, E_UNEXPECTED a E_OUTOFMEMORY a také následující:

Hodnota	Popis
S_OK	Vytvořili jsme připojení poradce.
E_NOTIMPL	Tato metoda není implementována v datovém objektu.
DV_E_LINDEX	Pro ; v současné době je lindexpodporována pouze -1.
DV_E_FORMATETC	Parametr má neplatnou hodnotu pFormatetc .
OLE_E_ADVISENOTSUPPORTED	Datový objekt nepodporuje oznámení o změnách.

Implementuje

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Poznámky

Tento člen je explicitní implementace člena rozhraní. Lze jej použít pouze v případech, kdy DataObject se přetypuje na IDataObject rozhraní.