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

Referenz

Definition

Namespace:: System.Runtime.InteropServices.ComTypes

Assembly:: System.Runtime.InteropServices.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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.

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 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.

adviseSink: IAdviseSink

Ein Zeiger auf die IAdviseSink-Schnittstelle der Advise-Senke, die die Änderungsbenachrichtigung empfängt.

connection: 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

Int32

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.

Hinweise

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

Gilt für:

Freigeben über