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

Définition

Espace de noms:
System.Runtime.InteropServices.ComTypes
Assembly:
System.dll
Assembly:
netstandard.dll

Crée une connexion entre un objet de données et un récepteur consultatif. Cette méthode est appelée par un objet qui prend en charge un récepteur consultatif et permet au récepteur consultatif d’être informé 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, l’appareil cible, l’aspect et le support qui seront utilisés pour les notifications futures.

advf
ADVF

Une des ADVF valeurs qui spécifie un groupe d’indicateurs pour contrôler la connexion de conseil.

adviseSink
IAdviseSink

Pointeur vers l’interface IAdviseSink sur le récepteur consultatif qui recevra la notification de modification.

connection
Int32

Lorsque cette méthode est retournée, contient un pointeur vers un jeton DWORD qui identifie cette connexion. Vous pouvez utiliser ce jeton ultérieurement pour supprimer la connexion de conseil en le transmettant à DUnadvise(Int32). Si cette valeur est égale à zéro, la connexion n’a pas été établie. Ce paramètre est passé non initialisé.

Retours

Int32

Cette méthode prend en charge 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 conseil 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, seul -1 est pris en charge.
DV_E_FORMATETC Il existe une valeur non valide pour le pFormatetc paramètre.
OLE_E_ADVISENOTSUPPORTED L’objet de données ne prend pas en charge la notification de modification.

Remarques

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

S’applique à