DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
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 ^ pAdvSink, [Runtime::InteropServices::Out] int % pdwConnection) = 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 pAdvSink, out int pdwConnection);
abstract member System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int
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, pAdvSink As IAdviseSink, ByRef pdwConnection As Integer) As Integer Implements IDataObject.DAdvise
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.
- pAdvSink
- IAdviseSink
Pointeur vers l'interface IAdviseSink sur le récepteur de notifications qui recevra la notification de modifications.
- pdwConnection
- 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
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. |
Implémente
Remarques
Ce membre est une implémentation d'un membre d'interface explicite. Il peut être utilisé uniquement lorsque le DataObject est casté en une interface IDataObject.