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

Inicia uma conexão com IExplorerBrowser para retornos de chamada de evento.

Sintaxe

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

Parâmetros

[in] psbe

Tipo: IExplorerBrowserEvents*

Um ponteiro para a interface IExplorerBrowserEvents do objeto a ser avisado dos eventos IExplorerBrowser .

[out] pdwCookie

Tipo: DWORD*

Quando esse método retorna, contém um token que identifica exclusivamente o ouvinte de eventos. Isso permite que vários ouvintes de eventos sejam inscritos por vez.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método é chamado por um implementador de IExplorerBrowserEvents. O implementador (ouvinte) é avisado dos eventos de exibição e navegação ExplorerBrowser por retorno de chamada dos métodos de IExplorerBrowserEvents.

Chame IExplorerBrowser::Advise para iniciar uma conexão de consultoria antes da primeira navegação IExplorerBrowser . Os retornos de chamada para ouvintes de eventos são feitos à medida que o navegador está navegando.

A primeira navegação ocorre de forma síncrona a uma chamada em IExplorerBrowser::BrowseToObject ou um método semelhante. Retornos de chamada futuros ocorrem de forma assíncrona, à medida que o navegador navega.

Quando a conexão não for mais necessária, chame o método IExplorerBrowser::Unadvise para encerrar a conexão.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)

Confira também

IExplorerBrowser

OnNavigationComplete

Onnavigationfailed

OnViewCreated