IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Methode

Definition

Namespace:
System.Runtime.InteropServices.ComTypes
Assemblys:
netstandard.dll, System.Runtime.InteropServices.dll
Assembly:
System.Runtime.InteropServices.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Quelle:
IDataObject.cs
Quelle:
IDataObject.cs
Quelle:
HandleCollector.cs

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.

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 -> int
Public Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer

Parameter

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.

adviseSink
IAdviseSink

Ein Zeiger auf die Schnittstelle auf der IAdviseSink Empfehlungsspüle, die die Änderungsbenachrichtigung empfängt.

connection
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

Int32

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.

Hinweise

Weitere Informationen finden Sie unter IDataObject::D Advise-Methode.

Gilt für: