OleDataObject.IDataObject.DAdvise(FORMATETC[], UInt32, IAdviseSink, UInt32) Methode

Definition

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

Int32

Das Ergebnis lautet S_OK, wenn die Methode erfolgreich ausgeführt wird, andernfalls ein Fehlercode.

Implementiert

Gilt für