DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee maakt u een verbinding tussen een gegevensobject en een adviessink. Deze methode wordt aangeroepen door een object dat ondersteuning biedt voor een adviessink en stelt de adviessink in staat om op de hoogte te worden gesteld van wijzigingen in de gegevens van het object.
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 -> intFunction DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, pAdvSink As IAdviseSink, ByRef pdwConnection As Integer) As Integer Implements IDataObject.DAdviseParameters
- pFormatetc
- FORMATETC
Een FORMATETC structuur, doorgegeven door verwijzing, die de indeling, het doelapparaat, het aspect en het medium definieert dat wordt gebruikt voor toekomstige meldingen.
- advf
- ADVF
Een van de ADVF waarden waarmee een groep vlaggen wordt opgegeven voor het beheren van de adviesverbinding.
- pAdvSink
- IAdviseSink
Een aanwijzer naar de IAdviseSink interface op de adviessink die de wijzigingsmelding ontvangt.
- pdwConnection
- Int32
Wanneer deze methode wordt geretourneerd, bevat een aanwijzer naar een DWORD-token waarmee deze verbinding wordt geïdentificeerd. U kunt dit token later gebruiken om de adviesverbinding te verwijderen door deze door te geven aan DUnadvise(Int32). Als deze waarde nul is, is de verbinding niet tot stand gebracht. Deze parameter wordt niet-geïnitialiseerd doorgegeven.
Retouren
Deze methode ondersteunt de standaard retourwaarden E_INVALIDARG, E_UNEXPECTED en E_OUTOFMEMORY, evenals de volgende:
| Waarde | Beschrijving |
|---|---|
| S_OK | De adviesverbinding is gemaakt. |
| E_NOTIMPL | Deze methode wordt niet geïmplementeerd in het gegevensobject. |
| DV_E_LINDEX | Er is een ongeldige waarde voor lindex; momenteel wordt alleen -1 ondersteund. |
| DV_E_FORMATETC | Er is een ongeldige waarde voor de pFormatetc parameter.
|
| OLE_E_ADVISENOTSUPPORTED | Het gegevensobject biedt geen ondersteuning voor wijzigingsmeldingen. |
Implementeringen
Opmerkingen
Dit lid is een expliciete implementatie van interfaceleden. Deze kan alleen worden gebruikt wanneer de DataObject cast naar een IDataObject interface wordt verzonden.
