ClipboardObject.IDataObject.DAdvise Methode

Definition

Namespace:

Microsoft.VisualStudio.Data.Framework

Assembly:

Microsoft.VisualStudio.Data.Framework.dll

Erstellt eine Verbindung zwischen dem Zwischenablageobjekt und einer Beratungssenke. 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 ^ adviseSink, [Runtime::InteropServices::Out] int % connection) = 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 adviseSink, out int connection);

override this.System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int

Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer Implements IDataObject.DAdvise

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

Ein Wert aus der Enumeration, der ADVF eine Gruppe von Flags zum Steuern der Advisory-Verbindung angibt.

adviseSink

IAdviseSink

Ein IAdviseSink Objekt, das auf die Empfehlungssenke verweist, die die Änderungsbenachrichtigung empfängt.

connection

Int32

Out-Parameter. Wenn diese Methode zurückgibt, enthält dieser Parameter ein Token, das diese Verbindung identifiziert. Sie können mit diesem Token später die Advise-Verbindung durch das Übergeben an IDataObject.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 folgendes: ValueDescriptionS_OKThe Advisory-Verbindung wurde erstellt. E_NOTIMPLThis Methode ist nicht für die Daten implementiert object.DV_E_LINDEXThere ist ein ungültiger Wert für lindex; derzeit ist nur -1 supported.DV_E_FORMATETCThere ein ungültiger Wert für den pFormatetc Parameter ist. OLE_E_ADVISENOTSUPPORTEDThe Datenobjekt unterstützt keine Änderungsbenachrichtigung.

Implementiert

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)