Metodo IExplorerBrowser::Advise (shobjidl_core.h)

Avvia una connessione con IExplorerBrowser per i callback degli eventi.

Sintassi

HRESULT Advise(
  [in]  IExplorerBrowserEvents *psbe,
  [out] DWORD                  *pdwCookie
);

Parametri

[in] psbe

Tipo: IExplorerBrowserEvents*

Puntatore all'interfaccia IExplorerBrowserEvents dell'oggetto da consigliare degli eventi IExplorerBrowser .

[out] pdwCookie

Tipo: DWORD*

Quando termina, questo metodo contiene un token che identifica in modo univoco il listener dell'evento. In questo modo è possibile sottoscrivere più listener di eventi alla volta.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo viene chiamato da un implementatore di IExplorerBrowserEvents. L'implementatore (listener) è consigliato per gli eventi di visualizzazione e navigazione explorerBrowser tramite callback dei metodi di IExplorerBrowserEvents.

Chiama IExplorerBrowser::Advise per avviare una connessione consultiva prima della prima navigazione IExplorerBrowser . I callback ai listener di eventi vengono eseguiti durante l'esplorazione del browser.

La prima ricerca viene eseguita in modo sincrono a una chiamata su IExplorerBrowser::BrowseToObject o un metodo simile. I callback futuri vengono eseguiti in modo asincrono, man mano che il browser esplora.

Quando la connessione non è più necessaria, chiamare il metodo IExplorerBrowser::Unadvise per terminare la connessione.

Requisiti

Vedi anche

IExplorerBrowser

OnNavigationComplete

OnNavigationFailed

OnViewCreated