ILCreateFromPathA 函数 (shlobj_core.h)

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

语法

PIDLIST_ABSOLUTE ILCreateFromPathA(
  [in] PCSTR pszPath
);

参数

[in] pszPath

类型:PCTSTR

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

返回值

类型:PIDLIST_ABSOLUTE

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

言论

调用 ILFree,以在完成后释放 ITEMIDLIST

注意

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

要求

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