Método IExplorerBrowserEvents::OnNavigationFailed (shobjidl_core.h)

Notifica os clientes de que o navegador Explorer falhou ao navegar até uma pasta shell.

Sintaxe

HRESULT OnNavigationFailed(
  [in] PCIDLIST_ABSOLUTE pidlFolder
);

Parâmetros

[in] pidlFolder

Tipo: PCIDLIST_ABSOLUTE

Um PIDL que especifica a pasta.

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 após o método IExplorerBrowserEvents::OnViewCreated, supondo uma criação de exibição bem-sucedida.

Após uma criação de navegação e exibição, IExplorerBrowserEvents::OnNavigationComplete ou IExplorerBrowserEvents::OnNavigationFailed é chamado, dependendo se o destino pode ser navegado. Por exemplo, uma falha ao navegar inclui um destino que não foi atingido porque não há rota para o caminho ou o usuário cancelou.

Requisitos