Método IShellBrowser::BrowseObject (shobjidl_core.h)
Informa al Explorador de Windows para ir a otra carpeta.
Sintaxis
HRESULT BrowseObject(
PCUIDLIST_RELATIVE pidl,
UINT wFlags
);
Parámetros
pidl
Tipo: PCUIDLIST_RELATIVE
Dirección de una estructura ITEMIDLIST (lista de identificadores de elemento) que especifica la ubicación de un objeto. Este valor depende de la marca o marcas establecidas en el parámetro wFlags .
wFlags
Tipo: UINT
Marcas que especifican la carpeta que se va a examinar. Puede ser cero o uno o varios de los valores siguientes.
Estas marcas especifican si se va a crear otra ventana.
SBSP_DEFBROWSER (0x0000)
Use el comportamiento predeterminado, que respeta la opción de vista (la configuración del usuario para crear nuevas ventanas o para examinarla). En la mayoría de los casos, las aplicaciones que llaman deben usar esta marca.
SBSP_SAMEBROWSER
Vaya a otra carpeta con la misma ventana del Explorador de Windows.
SBSP_NEWBROWSER
Crea otra ventana para la carpeta especificada.
Las marcas siguientes especifican el modo . Estos valores se omiten si se especifica SBSP_SAMEBROWSER o si se especifica SBSP_DEFBROWSER y el usuario ha seleccionado Examinar en contexto.
SBSP_DEFMODE
Use la ventana actual.
SBSP_OPENMODE
Especifica ningún árbol de carpetas para la nueva ventana de exploración. Si el explorador actual no coincide con el SBSP_OPENMODE de la llamada al objeto browse, se abre una nueva ventana.
SBSP_EXPLOREMODE
Especifica un árbol de carpetas para la nueva ventana de exploración. Si el explorador actual no coincide con el SBSP_EXPLOREMODE de la llamada al objeto browse, se abre una nueva ventana.
SBSP_HELPMODE
No compatible. No debe usarse.
SBSP_NOTRANSFERHIST
No transfiera el historial de exploración a la nueva ventana.
Las marcas siguientes especifican la categoría del parámetro pidl .
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_ALLOW_AUTONAVIGATE (0x00010000)
Habilite la navegación automática.
Las marcas siguientes especifican el modo .
SBSP_KEEPSAMETEMPLATE (0x00020000)
Windows Vista y versiones posteriores. No compatible. No debe usarse.
SBSP_KEEPWORDWHEELTEXT (0x00040000)
Windows Vista y versiones posteriores. Navegue sin borrar el campo de entrada de búsqueda.
SBSP_ACTIVATE_NOFOCUS (0x00080000)
Windows Vista y versiones posteriores. Navegue sin el comportamiento predeterminado de establecer el foco en la nueva vista.
Las marcas siguientes controlan cómo se manipula el historial como resultado de la navegación.
SBSP_CALLERUNTRUSTED (0x00800000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) y versiones posteriores. Es posible que una página web haya iniciado la navegación con código de scripting ya presente en el sistema local.
SBSP_TRUSTFIRSTDOWNLOAD (0x01000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) y versiones posteriores. La nueva ventana es el resultado de una acción iniciada por el usuario. Confíe en la nueva ventana si intenta descargar contenido inmediatamente.
SBSP_UNTRUSTEDFORDOWNLOAD (0x02000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) y versiones posteriores. La ventana se desplaza a un archivo que no es de confianza y no ES HTML. Si el usuario intenta descargar el archivo, no permita la descarga.
SBSP_NOAUTOSELECT
Suprima la selección en el panel historial.
SBSP_WRITENOHISTORY
No escriba ningún historial de esta navegación en la carpeta shell del historial.
SBSP_CREATENOHISTORY (0x00100000)
0x00100000. Windows 7 y versiones posteriores. No agregue una nueva entrada al registro de viajes. Cuando el usuario escribe un término de búsqueda en el cuadro de búsqueda y, posteriormente, refina la consulta, el explorador navega hacia delante, pero no agrega una entrada de registro de viajes adicional.
SBSP_TRUSTEDFORACTIVEX (0x10000000)
Microsoft Internet Explorer 6 Service Pack 2 (SP2) y versiones posteriores. La navegación debe permitir avisos de ActiveX.
SBSP_FEEDNAVIGATION (0x20000000)
Windows Internet Explorer 7 y versiones posteriores. Si se permite mediante la configuración actual del Registro, asigne al explorador un destino al que navegar.
SBSP_REDIRECT (0x40000000)
Habilita el redireccionamiento a otra dirección URL.
SBSP_INITIATEDBYHLINKFRAME (0x80000000)
SBSP_PLAYNOSOUND (0x00200000)
Windows 7 y versiones posteriores. No haga que el sonido de navegación sea completo para cada pulsación de tecla en el cuadro de búsqueda.
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
Las vistas pueden usar este método para forzar que el Explorador de Windows examine un lugar específico en el espacio de nombres. Normalmente, estas son carpetas contenidas en la vista.
Ejemplos
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 compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (incluya Shobjidl.h) |
| Archivo DLL | Shell32.dll (versión 4.0 o posterior) |