IExplorerBrowser：：BrowseToIDList 方法 (shobjidl_core.h)

浏览到指向 PIDL) 项标识符列表 (指针

语法

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

参数

[in] pidl

类型： PCUIDLIST_RELATIVE

指向 const ITEMIDLIST (项标识符列表) 的指针，该列表将对象的位置指定为要导航到的目标。 此参数可以为 NULL。 有关详细信息，请参阅“备注”。

[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 中指定的标志指示通过内置 TravelLog（即SBSP_NAVIGATEBACK或SBSP_NAVIGATEFORWARD）导航，则参数 pidl 可以为 NULL。

此方法仅支持 shobjidl.h 文件中列出的 SBSP 标志的子集。 因此，如果在 uFlags 中指定了SBSP_NEWBROWSER或SBSP_EXPLOREMODE，此方法将返回E_INVALIDARG。

要求

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

另请参阅

BrowseObject

IExplorerBrowser