OleDataObject.IDataObject.DAdvise(FORMATETC[], UInt32, IAdviseSink, UInt32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine Verbindung zwischen dem Datenobjekt und einem Aufruferobjekt her, das die IAdviseSink-Schnittstelle implementiert.
virtual int Microsoft.VisualStudio.OLE.Interop.IDataObject.DAdvise(cli::array <Microsoft::VisualStudio::OLE::Interop::FORMATETC> ^ pFormatetc, System::UInt32 ADVF, Microsoft::VisualStudio::OLE::Interop::IAdviseSink ^ pAdvSink, [Runtime::InteropServices::Out] System::UInt32 % pdwConnection) = Microsoft::VisualStudio::OLE::Interop::IDataObject::DAdvise;
int IDataObject.DAdvise (Microsoft.VisualStudio.OLE.Interop.FORMATETC[] pFormatetc, uint ADVF, Microsoft.VisualStudio.OLE.Interop.IAdviseSink pAdvSink, out uint pdwConnection);
abstract member Microsoft.VisualStudio.OLE.Interop.IDataObject.DAdvise : Microsoft.VisualStudio.OLE.Interop.FORMATETC[] * uint32 * Microsoft.VisualStudio.OLE.Interop.IAdviseSink * uint32 -> int
override this.Microsoft.VisualStudio.OLE.Interop.IDataObject.DAdvise : Microsoft.VisualStudio.OLE.Interop.FORMATETC[] * uint32 * Microsoft.VisualStudio.OLE.Interop.IAdviseSink * uint32 -> int
Function DAdvise (pFormatetc As FORMATETC(), ADVF As UInteger, pAdvSink As IAdviseSink, ByRef pdwConnection As UInteger) As Integer Implements IDataObject.DAdvise
Parameter
- pFormatetc
- FORMATETC[]
Zeiger auf eine FORMATETC-Struktur, die Format, Zielgerät, Aspekt und Medium für zukünftige Benachrichtigungen definiert. Beispielsweise möchte eine Senke möglicherweise nur wissen, wann sich die Bitmap-Darstellung der Daten im Datenobjekt ändert. Eine andere Senke ist möglicherweise nur am Metadateiformat des gleichen Objekts interessiert. Jede Advise-Senke wird benachrichtigt, wenn sich die relevanten Daten ändern. Diese Daten werden an die Advise-Senke übergeben, wenn eine Benachrichtigung auftritt.
- ADVF
- UInt32
DWORD-Wert, der eine Gruppe von Flags zum Kontrollieren der Advise-Verbindung angibt. Gültige Werte werden der ADVF-Auflistung entnommen. Allerdings sind nur einige der möglichen ADVF-Werte für diese Methode relevant.
- pAdvSink
- IAdviseSink
Zeiger auf die IAdviseSink-Schnittstelle der Advise-Senke, die die Änderungsbenachrichtigung empfängt.
- pdwConnection
- UInt32
Zeiger auf ein DWORD Token, das diese Verbindung identifiziert. Sie können mit diesem Token später die Advise-Verbindung durch Übergeben an DUnadvise löschen. Wenn dieser Wert 0 (null) ist, wurde die Verbindung nicht hergestellt.
Gibt zurück
Das Ergebnis lautet S_OK, wenn die Methode erfolgreich ausgeführt wird, andernfalls ein Fehlercode.