IExplorerBrowser::Advise-Methode (shobjidl_core.h)
Initiiert eine Verbindung mit IExplorerBrowser für Ereignisrückrufe.
Syntax
HRESULT Advise(
[in] IExplorerBrowserEvents *psbe,
[out] DWORD *pdwCookie
);
Parameter
[in] psbe
Typ: IExplorerBrowserEvents*
Ein Zeiger auf die IExplorerBrowserEvents-Schnittstelle des Objekts, das über IExplorerBrowser-Ereignisse informiert werden soll.
[out] pdwCookie
Typ: DWORD*
Wenn diese Methode zurückgibt, enthält ein Token, das den Ereignislistener eindeutig identifiziert. Dadurch können mehrere Ereignislistener gleichzeitig abonniert werden.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Methode wird von einem Implementierer von IExplorerBrowserEvents aufgerufen. Der Implementierer (Listener) wird über ExplorerBrowser-Ansichts- und Navigationsereignisse durch Rückruf der Methoden von IExplorerBrowserEvents informiert.
Rufen Sie IExplorerBrowser::Advise auf, um vor der ersten IExplorerBrowser-Navigation eine Beratungsverbindung zu initiieren. Rückrufe an Ereignislistener werden ausgeführt, während der Browser durchsucht.
Der erste Durchsuchen erfolgt synchron mit einem Aufruf von IExplorerBrowser::BrowseToObject oder einer ähnlichen Methode. Zukünftige Rückrufe erfolgen asynchron, wenn der Browser durchsucht.
Wenn die Verbindung nicht mehr benötigt wird, rufen Sie die Methode IExplorerBrowser::Unadvise auf, um die Verbindung zu beenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shobjidl_core.h (einschließlich Shobjidl.h) |