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

Busca un objeto.

Sintaxis

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

Parámetros

[in] punk

Tipo: IUnknown*

Puntero a un objeto al que se va a examinar. Si no se puede examinar el objeto, se devuelve un valor de error.

[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

Examine 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

uFlags puede ser cualquiera de los EXPLORER_BROWSER_FILL_FLAGS o cualquiera de las marcas definidas en el parámetro wFlags de BrowseObject, excepto las marcas que indican la navegación.

Este método llama a GetIDList y busca el pidl devuelto. Funciona de la misma manera que IExplorerBrowser::BrowseToIDList, excepto que punk no puede ser NULL. El uso estándar es examinar un IShellFolder o un IShellItem. Se devolverá un error si el objeto pasado no se puede examinar. Un objeto que se puede examinar mediante implementa IPersistFolder2 o IPersistIDList.

La primera navegación de IExplorerBrowser es sincrónica. Después, todas las navegaciones son asincrónicas. Como resultado, las llamadas a IExplorerBrowser::BrowseToObject se realizarán correctamente si configura correctamente la navegación pendiente, pero eso no garantiza que la navegación se realice correctamente. Para informarse sobre el éxito y el error, los clientes deben implementar IExplorerBrowserEvents y responder adecuadamente en OnNavigationComplete y OnNavigationFailed.

Requisitos

Requisito	Value
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)