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 或更高版本)