Método IExplorerBrowser::Advise (shobjidl_core.h)

Inicia una conexión con IExplorerBrowser para devoluciones de llamada de eventos.

Sintaxis

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

Parámetros

[in] psbe

Tipo: IExplorerBrowserEvents*

Puntero a la interfaz IExplorerBrowserEvents del objeto que se recomienda de los eventos IExplorerBrowser .

[out] pdwCookie

Tipo: DWORD*

Cuando este método devuelve , contiene un token que identifica de forma única el agente de escucha de eventos. Esto permite que varios agentes de escucha de eventos se suscriban a la vez.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Un implementador de IExplorerBrowserEvents llama a este método. Se recomienda al implementador (agente de escucha) la vista ExplorerBrowser y los eventos de navegación mediante la devolución de llamada de los métodos de IExplorerBrowserEvents.

Llame a IExplorerBrowser::Advise para iniciar una conexión de asesoramiento antes de la primera navegación IExplorerBrowser . Las devoluciones de llamada a los agentes de escucha de eventos se realizan cuando el explorador está explorando.

La primera exploración se produce de forma sincrónica en una llamada en IExplorerBrowser::BrowseToObject o en un método similar. Las devoluciones de llamada futuras se producen de forma asincrónica, a medida que navega el explorador.

Cuando la conexión ya no sea necesaria, llame al método IExplorerBrowser::Unadvise para finalizar la conexión.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (incluya Shobjidl.h)

Consulte también

IExplorerBrowser

OnNavigationComplete

OnNavigationFailed

OnViewCreated