Método IShellBrowser::BrowseObject (shobjidl_core.h)
Informa a Explorer do Windows para navegar até outra pasta.
Sintaxe
HRESULT BrowseObject(
PCUIDLIST_RELATIVE pidl,
UINT wFlags
);
Parâmetros
pidl
Tipo: PCUIDLIST_RELATIVE
O endereço de uma estrutura ITEMIDLIST (lista de identificadores de item) que especifica a localização de um objeto. Esse valor depende do sinalizador ou sinalizador definido no parâmetro wFlags .
wFlags
Tipo: UINT
Sinalizadores especificando a pasta a ser navegada. Pode ser zero ou um ou mais dos valores a seguir.
Esses sinalizadores especificam se outra janela deve ser criada.
SBSP_DEFBROWSER (0x0000)
Use o comportamento padrão, que respeita a opção de exibição (a configuração do usuário para criar novas janelas ou navegar no local). Na maioria dos casos, chamar aplicativos deve usar esse sinalizador.
SBSP_SAMEBROWSER
Navegue até outra pasta com a mesma janela do Windows Explorer.
SBSP_NEWBROWSER
Cria outra janela para a pasta especificada.
Os sinalizadores a seguir especificam o modo . Esses valores serão ignorados se SBSP_SAMEBROWSER for especificado ou se SBSP_DEFBROWSER for especificado e o usuário tiver selecionado Procurar No Local.
SBSP_DEFMODE
Use a janela atual.
SBSP_OPENMODE
Especifica nenhuma árvore de pastas para a nova janela de navegação. Se o navegador atual não corresponder ao SBSP_OPENMODE da chamada de objeto de navegação, uma nova janela será aberta.
SBSP_EXPLOREMODE
Especifica uma árvore de pastas para a nova janela de navegação. Se o navegador atual não corresponder ao SBSP_EXPLOREMODE da chamada de objeto de navegação, uma nova janela será aberta.
SBSP_HELPMODE
Sem suporte. Não use.
SBSP_NOTRANSFERHIST
Não transfira o histórico de navegação para a nova janela.
Os sinalizadores a seguir especificam a categoria do parâmetro pidl .
SBSP_ABSOLUTE
Um PIDL absoluto, relativo à área de trabalho.
SBSP_RELATIVE
Um PIDL relativo, em relação à pasta atual.
SBSP_PARENT
Navegue pela pasta pai, ignore o PIDL.
SBSP_NAVIGATEBACK
Navegue de volta, ignore o PIDL.
SBSP_NAVIGATEFORWARD
Navegue para frente, ignore o PIDL.
SBSP_ALLOW_AUTONAVIGATE (0x00010000)
Habilitar a navegação automática.
Os sinalizadores a seguir especificam o modo.
SBSP_KEEPSAMETEMPLATE (0x00020000)
Windows Vista e posteriores. Sem suporte. Não use.
SBSP_KEEPWORDWHEELTEXT (0x00040000)
Windows Vista e posteriores. Navegue sem limpar o campo de entrada de pesquisa.
SBSP_ACTIVATE_NOFOCUS (0x00080000)
Windows Vista e posteriores. Navegue sem o comportamento padrão de definir o foco no novo modo de exibição.
Os sinalizadores a seguir controlam como o histórico é manipulado como resultado da navegação.
SBSP_CALLERUNTRUSTED (0x00800000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) e posterior. A navegação possivelmente foi iniciada por uma página da Web com código de script já presente no sistema local.
SBSP_TRUSTFIRSTDOWNLOAD (0x01000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) e posterior. A nova janela é o resultado de uma ação iniciada pelo usuário. Confie na nova janela se ela tentar baixar imediatamente o conteúdo.
SBSP_UNTRUSTEDFORDOWNLOAD (0x02000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) e posterior. A janela está navegando para um arquivo não HTML não confiável. Se o usuário tentar baixar o arquivo, não permita o download.
SBSP_NOAUTOSELECT
Suprime a seleção no painel de histórico.
SBSP_WRITENOHISTORY
Não escreva nenhum histórico dessa navegação na pasta shell do histórico.
SBSP_CREATENOHISTORY (0x00100000)
0x00100000. Windows 7 e posterior. Não adicione uma nova entrada ao log de viagens. Quando o usuário insere um termo de pesquisa na caixa de pesquisa e, posteriormente, refina a consulta, o navegador navega para frente, mas não adiciona uma entrada de log de viagem adicional.
SBSP_TRUSTEDFORACTIVEX (0x10000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) e posterior. A navegação deve permitir prompts ActiveX.
SBSP_FEEDNAVIGATION (0x20000000)
Windows Internet Explorer 7 e posterior. Se permitido pelas configurações atuais do Registro, dê ao navegador um destino para navegar.
SBSP_REDIRECT (0x40000000)
Habilita o redirecionamento para outra URL.
SBSP_INITIATEDBYHLINKFRAME (0x80000000)
SBSP_PLAYNOSOUND (0x00200000)
Windows 7 e posterior. Não faça o som completo da navegação para cada pressionamento de tecla na caixa de pesquisa.
Valor retornado
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
As exibições podem usar esse método para forçar o Windows Explorer a navegar até um local específico no namespace. Normalmente, essas são pastas contidas na exibição.
Exemplos
IShellBrowser* psb;
hr = IUnknown_QueryService(punkSite, SID_STopLevelBrowser, IID_PPV_ARGS(&psb));
if (SUCCEEDED(hr))
{
hr = psb->BrowseObject(pidlSearch, SBSP_DEFBROWSER | SBSP_ABSOLUTE);
psb->Release();
}
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shobjidl_core.h (inclua Shobjidl.h) |
| DLL | Shell32.dll (versão 4.0 ou posterior) |