Método IFileDialog2::SetNavigationRoot (shobjidl.h)

Especifica um local de nível superior do qual começar a procurar um namespace, por exemplo, na opção Desativar pasta Procurar da caixa de diálogo. Os usuários não podem navegar acima desse local.

Sintaxe

HRESULT SetNavigationRoot(
  [in] IShellItem *psi
);

Parâmetros

[in] psi

Tipo: IShellItem

Ponteiro para um objeto IShellItem que representa a raiz de navegação.

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

SetNavigationRoot pode ser usado por aplicativos que desejam restringir a navegação a uma determinada área do namespace shell. Os itens no painel de navegação são substituídos pelo item fornecido para orientar o usuário a navegar para fora dessa parte do namespace.

Esse método não pode ser chamado enquanto a caixa de diálogo está sendo exibida.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl.h
Biblioteca	Comdlg32.lib
DLL	Comdlg32.dll (versão 6.1 ou posterior)

Confira também

IFileDialog2