IExplorerBrowser::Advise-Methode (shobjidl_core.h)

Artikel
03/02/2024

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)

Weitere Informationen