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

Definice

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.

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

advf
ADVF

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

pAdvSink
IAdviseSink

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

pdwConnection
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

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.

Implementuje

Poznámky

Tento člen je explicitní implementace členu rozhraní. Lze ji použít pouze při DataObject přetypování na IDataObject rozhraní.

Platí pro