DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Metoda
Definice
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.
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í.
- 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í.