DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) 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.
Erstellt eine Verbindung zwischen einem Datenobjekt und einer Beratenden Spüle. Diese Methode wird von einem Objekt aufgerufen, das eine Beratende Spüle unterstützt und ermöglicht es der Beratenden Spüle, über Änderungen in den Daten des Objekts benachrichtigt zu werden.
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.DAdviseParameter
- pFormatetc
- FORMATETC
Eine FORMATETC Struktur, die durch Verweis übergeben wird, die das Format, das Zielgerät, den Aspekt und das Medium definiert, das für zukünftige Benachrichtigungen verwendet wird.
- advf
- ADVF
Einer der ADVF Werte, die eine Gruppe von Flags zum Steuern der Beratenden Verbindung angibt.
- pAdvSink
- IAdviseSink
Ein Zeiger auf die Schnittstelle auf der IAdviseSink Empfehlungsspüle, die die Änderungsbenachrichtigung empfängt.
- pdwConnection
- Int32
Wenn diese Methode zurückgegeben wird, enthält sie einen Zeiger auf ein DWORD-Token, das diese Verbindung identifiziert. Sie können dieses Token später verwenden, um die Empfehlungsverbindung zu löschen, indem Sie es an DUnadvise(Int32). Wenn dieser Wert null ist, wurde die Verbindung nicht hergestellt. Dieser Parameter wird nicht initialisiert übergeben.
Gibt zurück
Diese Methode unterstützt die Standardrücklaufwerte E_INVALIDARG, E_UNEXPECTED und E_OUTOFMEMORY sowie folgendes:
| Wert: | Beschreibung |
|---|---|
| S_OK | Die Beratungsverbindung wurde erstellt. |
| E_NOTIMPL | Diese Methode wird für das Datenobjekt nicht implementiert. |
| DV_E_LINDEX | Es gibt einen ungültigen Wert für lindex; derzeit wird nur -1 unterstützt. |
| DV_E_FORMATETC | Für den pFormatetc Parameter ist ein ungültiger Wert vorhanden.
|
| OLE_E_ADVISENOTSUPPORTED | Das Datenobjekt unterstützt keine Änderungsbenachrichtigung. |
Implementiert
Hinweise
Dieses Element ist eine explizite Schnittstellenmitgliedsimplementierung. Sie kann nur verwendet werden, wenn die DataObject Umwandlung in eine IDataObject Schnittstelle erfolgt.
