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)

Confira também

IShellBrowser