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.
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 -> intPublic Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As IntegerParameters
- 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.
- adviseSink
- IAdviseSink
Een aanwijzer naar de IAdviseSink interface op de adviessink die de wijzigingsmelding ontvangt.
- connection
- 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. |
Opmerkingen
Zie de methode IDataObject::D Advise voor meer informatie.
