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 中引入) |