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

Definice

Obor názvů:
System.Runtime.InteropServices.ComTypes
Sestavení:
netstandard.dll, System.Runtime.InteropServices.dll
Sestavení:
System.Runtime.InteropServices.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll
Zdroj:
IDataObject.cs
Zdroj:
IDataObject.cs
Zdroj:
HandleCollector.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.

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 použijí pro budoucí oznámení.

advf
ADVF

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

adviseSink
IAdviseSink

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

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

Poznámky

Další informace naleznete v tématu IDataObject::D Advise metoda.

Platí pro