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

Busca un puntero a una lista de identificadores de elemento (PIDL)

Sintaxis

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

Parámetros

[in] pidl

Tipo: PCUIDLIST_RELATIVE

Puntero a un elemento ITEMIDLIST (lista de identificadores de elemento) que especifica la ubicación de un objeto como destino al que navegar. Este parámetro puede ser NULL. Para obtener más información, vea la sección Comentarios.

[in] uFlags

Tipo: UINT

Marca que especifica la categoría del pidl. Esto afecta a cómo se logra la navegación. Debe ser el valor cero o una combinación bit a bit de los valores siguientes.

SBSP_ABSOLUTE

PiDL absoluto, en relación con el escritorio.

SBSP_RELATIVE

Un PIDL relativo, con respecto a la carpeta actual.

SBSP_PARENT

Vaya a la carpeta primaria, omita el PIDL.

SBSP_NAVIGATEBACK

Vuelva a navegar, omita el PIDL.

SBSP_NAVIGATEFORWARD

Vaya hacia adelante, omita el PIDL.

SBSP_KEEPWORDWHEELTEXT

Windows Vista y versiones posteriores. Esta marca indica que se debe conservar cualquier texto de búsqueda escrito por wordWheel (el cuadro Buscar en el Explorador de Windows) durante esta navegación, de modo que los elementos de la nueva ubicación se filtren de la misma manera que se filtraron en la ubicación anterior.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El parámetro pidl puede ser NULL si las marcas especificadas en uFlags indican la navegación a través del TravelLog integrado, es decir, SBSP_NAVIGATEBACK o SBSP_NAVIGATEFORWARD.

Este método solo admite un subconjunto de las marcas SBSP enumeradas en el archivo shobjidl.h. Por lo tanto, este método devuelve E_INVALIDARG si SBSP_NEWBROWSER o SBSP_EXPLOREMODE se especifican en uFlags.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)

Consulte también

BrowseObject

IExplorerBrowser