SHGetSpecialFolderLocation 函数 (shlobj_core.h)

[SHGetSpecialFolderLocation 不受支持,将来可能会更改或不可用。 请改用 SHGetFolderLocation。]

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

语法

HRESULT SHGetSpecialFolderLocation(
  [in]  HWND             hwnd,
  [in]  int              csidl,
  [out] PIDLIST_ABSOLUTE *ppidl
);

参数

[in] hwnd

类型:HWND

保留。

[in] csidl

类型: int

标识相关文件夹的 CSIDL 值。

[out] ppidl

类型: PIDLIST_ABSOLUTE*

指定文件夹相对于桌面) 命名空间根目录 (位置的 PIDL。 调用应用程序负责使用 CoTaskMemFree 释放返回的 IDList。

返回值

类型: HRESULT

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

要求

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

另请参阅

SHGetSpecialFolderPath