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

Reference

Definice

Obor názvů:: System.Runtime.InteropServices.ComTypes

Sestavení:: System.Runtime.InteropServices.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

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 datovým objektem 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.

public:
 int DAdvise(System::Runtime::InteropServices::ComTypes::FORMATETC % pFormatetc, System::Runtime::InteropServices::ComTypes::ADVF advf, System::Runtime::InteropServices::ComTypes::IAdviseSink ^ adviseSink, [Runtime::InteropServices::Out] int % connection);

public int DAdvise (ref System.Runtime.InteropServices.ComTypes.FORMATETC pFormatetc, System.Runtime.InteropServices.ComTypes.ADVF advf, System.Runtime.InteropServices.ComTypes.IAdviseSink adviseSink, out int connection);

abstract member DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int

Public Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer

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í.

advf: ADVF

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

adviseSink: IAdviseSink

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

connection: Int32

Když 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 tak, že ho předáte do DUnadvise(Int32). Pokud je tato hodnota nula, připojení nebylo navázáno. 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řilo se připojení poradce.
E_NOTIMPL	Tato metoda není u datového objektu implementována.
DV_E_LINDEX	Hodnota pro lindexje neplatná. V současné době se podporuje pouze hodnota -1.
DV_E_FORMATETC	Hodnota parametru `pFormatetc` není platná.
OLE_E_ADVISENOTSUPPORTED	Datový objekt nepodporuje oznámení o změnách.

Poznámky

Další informace najdete v tématu Metoda IDataObject::D Advise.

Platí pro

Sdílet prostřednictvím