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

Definice

Obor názvů:

System.Runtime.InteropServices.ComTypes

Sestavení:

System.Runtime.InteropServices.dll

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.