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 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h (包括 Shlobj.h、Shlobj_core.h)
Library Shell32.lib
DLL Shell32.dll (4.71 或更高版本)