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

Navega até um ponteiro para uma lista de identificadores de item (PIDL)

Sintaxe

HRESULT BrowseToIDList(
  [in] PCUIDLIST_RELATIVE pidl,
  [in] UINT               uFlags
);

Parâmetros

[in] pidl

Tipo: PCUIDLIST_RELATIVE

Um ponteiro para um ITEMIDLIST const (lista de identificadores de item) que especifica o local de um objeto como o destino para o qual navegar. Este parâmetro pode ser NULL. Para obter mais informações, consulte Comentários.

[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 até a 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.

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

O pidl de parâmetro poderá ser NULL se os sinalizadores especificados em uFlags indicarem navegação por meio do TravelLog interno, ou seja, SBSP_NAVIGATEBACK ou SBSP_NAVIGATEFORWARD.

Esse método dá suporte apenas a um subconjunto dos sinalizadores SBSP listados no arquivo shobjidl.h. Consequentemente, esse método retornará E_INVALIDARG se SBSP_NEWBROWSER ou SBSP_EXPLOREMODE forem especificados em uFlags.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)

Confira também

BrowseObject

IExplorerBrowser