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) |