ClipboardObject.IDataObject.DAdvise, méthode

Article
11/15/2012

Crée une connexion entre l'objet du presse-papiers et un récepteur de notifications.Cette méthode est appelée par un objet qui prend en charge un récepteur de notifications et elle lui permet d'être averti des modifications apportées aux données de l'objet.

Espace de noms : Microsoft.VisualStudio.Data.Framework
Assembly : Microsoft.VisualStudio.Data.Framework (dans Microsoft.VisualStudio.Data.Framework.dll)

Syntaxe

'Déclaration
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 ne prend pas en charge les implémentations d'interfaces explicites.

Paramètres

pFormatetc
Type : System.Runtime.InteropServices.ComTypes.FORMATETC%
Structure FORMATETC, passée par référence, qui définit le format, le périphérique cible, l'aspect et le support qui seront utilisés pour les futures notifications.

advf
Type : System.Runtime.InteropServices.ComTypes.ADVF
Une valeur de l'énumération d' ADVF qui spécifie un groupe de balises pour vérifier la connexion consultative.

adviseSink
Type : System.Runtime.InteropServices.ComTypes.IAdviseSink
Un objet d' IAdviseSink pointant sur le récepteur de notifications qui reçoit une notification de modifications.

connection
Type : System.Int32%
Paramètre de sortie.Lorsque cette méthode retourne, ce paramètre contient un jeton qui identifie cette connexion.Vous pouvez utiliser ultérieurement ce jeton pour supprimer la connexion de notifications en le passant à IDataObject.DUnadvise.Si cette valeur est nulle, la connexion n'a pas été établie.Ce paramètre est passé sans être initialisé.

Valeur de retour

Type : System.Int32
Cette méthode prend les valeurs de retour standard E_INVALIDARG, E_UNEXPECTED, et E_OUTOFMEMORY, ainsi que les éléments suivants :

Valeur	Description
S_OK	La connexion de notifications a été créée.
E_NOTIMPL	Cette méthode n'est pas implémentée sur l'objet de données.
DV_E_LINDEX	Il existe une valeur non valide pour lindex; actuel uniquement -1 est pris en charge.
DV_E_FORMATETC	Il existe une valeur non valide pour le paramètre pFormatetc.
OLE_E_ADVISENOTSUPPORTED	L'objet de données ne prend pas en charge la notification de modifications.

Implémentations

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

Notes

Cette méthode délègue l'appel à l' DAdvise correspondant de l'espace de noms d' System.Runtime.InteropServices.ComTypes , en supposant que l'objet du presse-papiers encapsule IDataObjectexistant.

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

ClipboardObject Classe

Microsoft.VisualStudio.Data.Framework, espace de noms

Partager via