ClipboardObject.IDataObject.DAdvise-Methode

Artikel
05/16/2015

Erstellt eine Verbindung zwischen dem Zwischenablageobjekt 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.

Namespace: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (in Microsoft.VisualStudio.Data.Framework.dll)

Syntax

'Declaration
Private Function DAdvise ( _
    ByRef pFormatetc As FORMATETC, _
    advf As ADVF, _
    adviseSink As IAdviseSink, _
    <OutAttribute> ByRef connection As Integer _
) As Integer Implements IDataObject.DAdvise

int IDataObject.DAdvise(
    ref FORMATETC pFormatetc,
    ADVF advf,
    IAdviseSink adviseSink,
    out int connection
)

private:
virtual int DAdvise(
    FORMATETC% pFormatetc, 
    ADVF advf, 
    IAdviseSink^ adviseSink, 
    [OutAttribute] int% connection
) sealed = IDataObject::DAdvise

private abstract DAdvise : 
        pFormatetc:FORMATETC byref * 
        advf:ADVF * 
        adviseSink:IAdviseSink * 
        connection:int byref -> int  
private override DAdvise : 
        pFormatetc:FORMATETC byref * 
        advf:ADVF * 
        adviseSink:IAdviseSink * 
        connection:int byref -> int

JScript unterstützt keine expliziten Schnittstellenimplementierungen

Parameter

pFormatetc
Typ: 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
Typ: ADVF

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

adviseSink
Typ: IAdviseSink

Ein IAdviseSink-Objekt, das auf der Advise-Senke zeigt, die die Änderungsbenachrichtigungen empfängt.

connection
Typ: Int32%

Out-Parameter. Wenn diese Methode beendet wird, 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 löschen. Wenn dieser Wert 0 (null) ist, wurde die Verbindung nicht hergestellt. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: Int32
Diese Methode unterstützt die Standardrückgabewerte E_INVALIDARG, E_UNEXPECTED und E_OUTOFMEMORY sowie Folgendes:

Wert	Beschreibung
S_OK	Die Advise-Verbindung wurde erstellt.
E_NOTIMPL	Diese Methode ist bei einem Datenobjekt nicht implementiert.
DV_E_LINDEX	Es gibt einen ungültigen Wert für lindex; derzeit nur -1 werden 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

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

Hinweise

Diese Methode delegiert den Aufruf an den entsprechenden DAdvise vom System.Runtime.InteropServices.ComTypes und Namespace angenommen, dass Zwischenablageobjekt vorhandenes IDataObject umschließt.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

ClipboardObject Klasse

Microsoft.VisualStudio.Data.Framework-Namespace

Freigeben über