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 Advise-Senke. Diese Methode wird von einem Objekt aufgerufen, das eine Advise-Senke unterstützt, und aktiviert die Advise-Senke für den Empfang von Änderungsbenachrichtigungen für Daten des Objekts.
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 als Verweis übergeben wird und für zukünftige Benachrichtigungen das Format, das Zielgerät, den Aspekt und das Medium definiert.
- advf
- ADVF
Einer der ADVF-Werte, der eine Gruppe von Flags für das Steuern der Advise-Verbindung angibt.
- pAdvSink
- IAdviseSink
Ein Zeiger auf die IAdviseSink-Schnittstelle der Advise-Senke, die die Änderungsbenachrichtigung empfängt.
- pdwConnection
- Int32
Enthält nach dem Beenden dieser Methode einen Zeiger auf ein DWORD-Token, das diese Verbindung identifiziert. Sie können mit diesem Token später die Advise-Verbindung durch das Übergeben an DUnadvise(Int32) löschen. Wenn dieser Wert 0 (null) ist, wurde die Verbindung nicht hergestellt. Dieser Parameter wird nicht initialisiert übergeben.
Gibt zurück
Diese Methode unterstützt die Standardrückgabewerte E_INVALIDARG, E_UNEXPECTED und E_OUTOFMEMORY sowie die folgenden Werte:
| Wert | BESCHREIBUNG |
|---|---|
| S_OK | Die Advise-Verbindung wurde erstellt. |
| E_NOTIMPL | Diese Methode ist bei einem Datenobjekt nicht implementiert. |
| DV_E_LINDEX | Ein Wert für lindex ist ungültig. Derzeit wird nur -1 unterstützt. |
| DV_E_FORMATETC | Ein Wert für den pFormatetc-Parameter ist ungültig.
|
| OLE_E_ADVISENOTSUPPORTED | Das Datenobjekt unterstützt keine Änderungsbenachrichtigung. |
Implementiert
Hinweise
Bei diesem Member handelt es sich um eine explizite Schnittstellenmemberimplementierung. Er kann nur verwendet werden, wenn das DataObject in eine IDataObject-Schnittstelle umgewandelt wird.
