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

Navega até um objeto .

Sintaxe

HRESULT BrowseToObject(
  [in] IUnknown *punk,
  [in] UINT     uFlags
);

Parâmetros

[in] punk

Tipo: IUnknown*

Um ponteiro para um objeto para o qual procurar. Se o objeto não puder ser navegado, um valor de erro será retornado.

[in] uFlags

Tipo: UINT

Um sinalizador que especifica a categoria do pidl. Isso afeta a forma como a navegação é realizada. Deve ser o valor zero ou uma combinação bit a bit dos valores a seguir.

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_KEEPWORDWHEELTEXT

Windows Vista e posteriores. Esse sinalizador indica que qualquer texto de pesquisa inserido por um WordWheel (a caixa Pesquisar no Windows Explorer) deve ser preservado durante essa navegação, para que os itens no novo local sejam filtrados da mesma forma que foram filtrados no local anterior.

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

UFlags pode ser qualquer um dos EXPLORER_BROWSER_FILL_FLAGS ou qualquer um dos sinalizadores definidos no parâmetro wFlags do BrowseObject, exceto para sinalizadores que indicam navegação.

Esse método chama GetIDList e navega até o pidl retornado. Ele opera da mesma maneira que IExplorerBrowser::BrowseToIDList, exceto que punk não pode ser NULL. O uso padrão é procurar um IShellFolder ou um IShellItem. Um erro será retornado se o objeto passado não puder ser navegado. Um objeto que pode ser navegado implementa IPersistFolder2 ou IPersistIDList.

A primeira navegação de IExplorerBrowser é síncrona. Depois disso, todas as navegaçãos são assíncronas. Como resultado, as chamadas para IExplorerBrowser::BrowseToObject terão êxito se você configurar corretamente a navegação pendente, mas isso não garante que a navegação será bem-sucedida. Para serem informados de êxito e falha, os clientes devem implementar IExplorerBrowserEvents e responder adequadamente em OnNavigationComplete e OnNavigationFailed.

Requisitos