SHCloneSpecialIDList 函数 (shlobj_core.h)

  • 项目

[SHCloneSpecialIDList 可在“要求”部分指定的操作系统中使用。 它可能在后续版本中变更或不可用。 请改用 SHGetSpecialFolderLocation.]

检索指向指定特殊文件夹的 ITEMIDLIST 结构的指针。

语法

PIDLIST_ABSOLUTE SHCloneSpecialIDList(
       HWND hwnd,
  [in] int  csidl,
  [in] BOOL fCreate
);

参数

hwnd

类型：HWND

保留。

[in] csidl

类型： int

标识相关文件夹的 CSIDL 值。

[in] fCreate

类型： BOOL

BOOL 类型的值，该值指示如果文件夹尚不存在，是否应创建该文件夹。 如果 fCreate 为 TRUE，则创建文件夹。 如果为 FALSE，则不创建文件夹。

返回值

类型： PIDLIST_ABSOLUTE

返回指向 csidl 指定的特殊文件夹的 ITEMIDLIST 结构的指针。 如果 fCreate 为 TRUE，则函数创建文件夹。

注解

完成后，应使用 ILFree 释放指向克隆文件夹的指针。

要求

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