SHGetPathFromIDListA 函数 (shlobj_core.h)

  • 项目

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

语法

BOOL SHGetPathFromIDListA(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] LPSTR             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 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h (包括 Shlobj.h、Shlobj_core.h)
Library Shell32.lib
DLL Shell32.dll (版本 4.0 或更高版本)
API 集 Windows 10版本 10.0.14393 中引入的 ext-ms-win-shell-shell32-l1- (2-2)

另请参阅

SHGetPathFromIDListEx

SHParseDisplayName