ILCreateFromPathA 函数 (shlobj_core.h)

返回与指定文件路径关联的 ITEMIDLIST 结构。

语法

PIDLIST_ABSOLUTE ILCreateFromPathA(
  [in] PCSTR pszPath
);

参数

[in] pszPath

类型： PCTSTR

指向包含路径的以 null 结尾的 Unicode 字符串的指针。 此字符串的长度不应超过 MAX_PATH 个字符，包括终止 null 字符。

返回值

类型： PIDLIST_ABSOLUTE

返回指向对应于路径的 ITEMIDLIST 结构的指针。

注解

使用完 ITEMIDLIST 后，调用 ILFree 释放它。

注意

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

要求

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