SHSimpleIDListFromPath 函数 (shobjidl_core.h)

  • 项目

已弃用。 在传递路径时返回指向 ITEMIDLIST 结构的指针。

语法

PIDLIST_ABSOLUTE SHSimpleIDListFromPath(
  [in] PCWSTR pszPath
);

参数

[in] pszPath

类型： PCWSTR

指向以 null 结尾的字符串的指针，该字符串包含要转换为 PIDL 的路径。

返回值

类型： PIDLIST_ABSOLUTE

如果成功，则返回指向 ITEMIDLIST 结构的指针，否则返回 NULL 。

注解

在 Windows 7 之前，此函数是在 Shlobj.h 中声明的。 在 Windows 7 及更高版本中，它在 Shobjidl.h 中声明。

注意 此函数可通过 Windows 7 和 Windows Server 2003 使用。 它可能在将来的 Windows 版本中不存在。
 
此函数的替代方法如下：
  1. 调用 SHGetDesktopFolder 以获取桌面文件夹的 IShellFolder 。
  2. 获取 IShellFolder 的绑定上下文 (IBindCtx) 。
  3. 使用 IBindCtx 和路径调用 IShellFolder：:P arseDisplayName。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
Library Shell32.lib
DLL Shell32.dll (版本 5.00 或更高版本)
API 集 ext-ms-win-shell-shell32-l1-2-1 (在 Windows 10 版本 10.0.10240 中引入)