IExplorerBrowser ::Advise, méthode (shobjidl_core.h)
Établit une connexion avec IExplorerBrowser pour les rappels d’événements.
Syntaxe
HRESULT Advise(
[in] IExplorerBrowserEvents *psbe,
[out] DWORD *pdwCookie
);
Paramètres
[in] psbe
Type : IExplorerBrowserEvents*
Pointeur vers l’interface IExplorerBrowserEvents de l’objet à avertir des événements IExplorerBrowser .
[out] pdwCookie
Type : DWORD*
Lorsque cette méthode est retournée, contient un jeton qui identifie de manière unique l’écouteur d’événements. Cela permet à plusieurs écouteurs d’événements d’être abonnés à la fois.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Cette méthode est appelée par un implémenteur de IExplorerBrowserEvents. L’implémenteur (écouteur) est informé des événements de navigation et d’affichage ExplorerBrowser par rappel des méthodes de IExplorerBrowserEvents.
Appelez IExplorerBrowser ::Advise pour lancer une connexion d’avis avant la première navigation IExplorerBrowser . Les rappels aux écouteurs d’événements sont effectués pendant que le navigateur est en cours de navigation.
La première navigation se produit de manière synchrone à un appel sur IExplorerBrowser ::BrowseToObject, ou à une méthode similaire. Les rappels ultérieurs se produisent de manière asynchrone, à mesure que le navigateur navigue.
Lorsque la connexion n’est plus nécessaire, appelez la méthode IExplorerBrowser ::Unadvise pour arrêter la connexion.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shobjidl_core.h (incluez Shobjidl.h) |