ClipboardObject.IDataObject.DAdvise 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 l’objet Presse-papiers et un récepteur d’avis. 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 ^ adviseSink, [Runtime::InteropServices::Out] int % connection) = 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 adviseSink, out int connection);
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, adviseSink As IAdviseSink, ByRef connection 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
Valeur de l’énumération ADVF qui spécifie un groupe d’indicateurs pour le contrôle de la connexion d’avis.
- adviseSink
- IAdviseSink
Objet IAdviseSink pointant vers le récepteur de conseil qui recevra la notification de modification.
- connection
- 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(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 standard E_INVALIDARG, E_UNEXPECTED et E_OUTOFMEMORY, ainsi que les éléments suivants : ValueDescriptionS_OKThe connexion de conseil a été créée. E_NOTIMPLThis méthode n’est pas implémentée sur les données object.DV_E_LINDEXThere n’est pas une valeur non valide pour lindex; actuellement, seule -1 est supported.DV_E_FORMATETCThere est une valeur non valide pour le pFormatetc
paramètre. OLE_E_ADVISENOTSUPPORTEDThe objet de données ne prend pas en charge la notification de modification.