IOleAdviseHolder ::Advise, méthode (oleidl.h)
Établit une connexion de conseil entre un objet OLE et le récepteur de conseil de l’objet appelant. Par le biais de ce récepteur, l’objet appelant peut recevoir une notification lorsque l’objet OLE est renommé, enregistré ou fermé.
Syntaxe
HRESULT Advise(
[in] IAdviseSink *pAdvise,
[out] DWORD *pdwConnection
);
Paramètres
[in] pAdvise
Pointeur vers l’interface IAdviseSink sur le récepteur de conseil qui doit être informé des modifications.
[out] pdwConnection
Pointeur vers un jeton qui peut être passé à la méthode IOleAdviseHolder ::Unadvise pour supprimer la connexion de conseil. L’objet appelant est responsable de l’appel de IUnknown ::AddRef et IUnknown ::Release sur ce pointeur.
Valeur retournée
Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Le pointeur d’interface IAdviseSink fourni n’est pas valide. |
Remarques
Les conteneurs, les gestionnaires d’objets et les objets de liaison permettent aux récepteurs de recevoir une notification des modifications apportées aux objets de document composés d’intérêt, tels que les objets incorporés ou liés. Les objets OLE d’intérêt pour ces objets doivent implémenter l’interface IOleObject , qui comprend plusieurs méthodes de conseil, notamment IOleObject ::Advise. Un appel à cette méthode doit configurer une connexion de conseil avec n’importe quel récepteur d’avis qui l’appelle et maintenir chaque connexion jusqu’à ce qu’elle soit fermée. Il doit être en mesure de gérer plusieurs connexions de conseil à la fois.
IOleAdviseHolder ::Advise est destiné à être utilisé pour simplifier l’implémentation d’IOleObject ::Advise. Vous pouvez obtenir un pointeur vers l’implémentation OLE de IOleAdviseHolder en appelant CreateOleAdviseHolder, puis, pour implémenter IOleObject ::Advise, il suffit de déléguer l’appel à IOleAdviseHolder ::Advise. D’autres méthodes IOleAdviseHolder sont destinées à implémenter d’autres méthodes de conseil IOleObject.
Si la tentative d’établissement d’une connexion de conseil réussit, l’objet recevant l’appel retourne une valeur différente de zéro par le biais de pdwConnection. Si la tentative échoue, l’objet retourne un zéro. Pour supprimer une connexion d’avis, l’objet avec le récepteur de conseil transmet ce jeton différent de zéro à l’objet en appelant IOleAdviseHolder ::Advise.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | oleidl.h |