SHGetPathFromIDListW 函数(shlobj_core.h)

将项标识符列表转换为文件系统路径。

语法

BOOL SHGetPathFromIDListW(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] LPWSTR            pszPath
);

参数

[in] pidl

类型:PCIDLIST_ABSOLUTE

项标识符列表的地址,该列表指定相对于命名空间(桌面)根目录的文件或目录位置。

[out] pszPath

类型:LPTSTR

要接收文件系统路径的缓冲区的地址。 此缓冲区的大小必须至少MAX_PATH个字符。

返回值

类型:BOOL

如果成功,则返回 TRUE;否则,FALSE

言论

如果 pidl 参数指定的位置不是文件系统的一部分,则此函数将失败。

如果 pidl 参数指定快捷方式,pszPath 将包含快捷方式的路径,而不是快捷方式的目标路径。

注意

shlobj_core.h 标头将 SHGetPathFromIDList 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 shlobj_core.h(包括 Shlobj.h、Shlobj_core.h)
Shell32.lib
DLL Shell32.dll(版本 4.0 或更高版本)
API 集 ext-ms-win-shell-shell32-l1-2-2 (在 Windows 10 版本 10.0.14393 中引入)

另请参阅

SHGetPathFromIDListEx

SHParseDisplayName