IExplorerBrowser：：BrowseToObject 方法 (shobjidl_core.h)

项目
03/02/2024

浏览到对象。

语法

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

参数

[in] punk

类型： IUnknown*

指向要浏览到的对象的指针。如果无法浏览对象，则返回错误值。

[in] uFlags

类型： UINT

一个指定 pidl 类别的标志。这会影响导航的完成方式。必须是值零或以下值的按位组合。

SBSP_ABSOLUTE

相对于桌面的绝对 PIDL。

SBSP_RELATIVE

相对于当前文件夹的相对 PIDL。

SBSP_PARENT

浏览父文件夹，忽略 PIDL。

SBSP_NAVIGATEBACK

向后导航，忽略 PIDL。

SBSP_NAVIGATEFORWARD

向前导航，忽略 PIDL。

SBSP_KEEPWORDWHEELTEXT

Windows Vista 及更高版本。此标志指示在 Windows 资源管理器) 的“搜索”框中，WordWheel (输入的任何搜索文本都应在此导航过程中保留，以便新位置的项目的筛选方式与在上一位置筛选项目的方式相同。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

注解

uFlags 可以是任何 EXPLORER_BROWSER_FILL_FLAGS 或 BrowseObject 的 wFlags 参数中定义的任何标志，但指示导航的标志除外。

此方法调用 GetIDList 并浏览到返回的 pidl。它的工作方式与 IExplorerBrowser：：BrowseToIDList 相同，但朋克不能为 NULL。标准用法是浏览到 IShellFolder 或 IShellItem。如果无法浏览传入的对象，将返回错误。可浏览的对象实现 IPersistFolder2 或 IPersistIDList。

IExplorerBrowser 的第一个导航是同步的。之后，所有导航都是异步的。因此，如果正确设置了挂起的导航，对 IExplorerBrowser：：BrowseToObject 的调用将成功，但这并不能保证导航会成功。若要了解成功和失败，客户端应实现 IExplorerBrowserEvents 并在 OnNavigationComplete 和 OnNavigationFailed 中做出相应响应。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	shobjidl_core.h (包括 Shobjidl.h)

通过