SHGetSpecialFolderPathA 函数 (shlobj_core.h)
[ 不支持SHGetSpecialFolderPath。 请改用 SHGetFolderPath.]
检索由其 CSIDL标识的特殊文件夹的路径。
语法
BOOL SHGetSpecialFolderPathA(
HWND hwnd,
[out] LPSTR pszPath,
[in] int csidl,
[in] BOOL fCreate
);
参数
hwnd
类型:HWND
保留。
[out] pszPath
类型:LPTSTR
指向以 null 结尾的字符串的指针,该字符串接收指定文件夹的驱动器和路径。 此缓冲区的大小必须至少MAX_PATH个字符。
[in] csidl
类型:int
标识相关文件夹的 CSIDL。 如果指定了虚拟文件夹,此函数将失败。
[in] fCreate
类型:BOOL
指示是否应创建该文件夹(如果尚不存在)。 如果此值为非零,则会创建文件夹。 如果此值为零,则不会创建文件夹。
返回值
类型:BOOL
如果成功,则 TRUE;否则,FALSE。
言论
必须安装 Microsoft Internet Explorer 4.0 桌面更新才能使用此函数。
注意
shlobj_core.h 标头将 SHGetSpecialFolderPath 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | 窗户 |
标头 | shlobj_core.h(包括 Shlobj.h、Shlobj_core.h) |
库 | Shell32.lib |
DLL | Shell32.dll(版本 4.71 或更高版本) |