IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Méthode

Définition

Espace de noms:

System.Runtime.InteropServices.ComTypes

Assembly:

System.Runtime.InteropServices.dll

Crée une connexion entre un objet de données 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.

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

Paramètres

pFormatetc

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

ADVF

L'une des valeurs ADVF spécifiant un groupe d'indicateurs pour le contrôle de la connexion de notifications.

adviseSink

IAdviseSink

Pointeur vers l'interface IAdviseSink sur le récepteur de notifications qui recevra la notification de modifications.

connection

Int32

Cette méthode retourne un pointeur vers un jeton DWORD qui identifie cette connexion. Vous pouvez utiliser ultérieurement ce jeton pour supprimer la connexion de notifications en le passant à DUnadvise(Int32). Si cette valeur est nulle, la connexion n'a pas été établie. Ce paramètre est passé sans être initialisé.

Retours

Int32

Cette méthode prend en charge les valeurs de retour E_INVALIDARG, E_UNEXPECTED et E_OUTOFMEMORY standard, ainsi que les suivantes :

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 ; actuellement, seule la valeur -1 est prise 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.

Remarques

Pour plus d’informations, consultez Méthode IDataObject ::D Advise.