GetSystemDirectoryA 函数（sysinfoapi.h）

检索系统目录的路径。系统目录包含系统文件，例如动态链接库和驱动程序。

此函数主要用于兼容性。应用程序应将代码存储在 Program Files 文件夹中，并将持久数据存储在用户配置文件的应用程序数据文件夹中。有关详细信息，请参阅 ShGetFolderPath。

语法

UINT GetSystemDirectoryA(
  [out] LPSTR lpBuffer,
  [in]  UINT  uSize
);

[out] lpBuffer

指向要接收路径的缓冲区的指针。除非系统目录是根目录，否则此路径不会以反斜杠结尾。例如，如果系统目录在驱动器 C 上命名为 Windows\System32，则此函数检索的系统目录的路径为 C：\Windows\System32。

[in] uSize

缓冲区的最大大小，以 TCHAr为单位。

如果函数成功，则返回值为复制到缓冲区的字符串 TCHAR长度，不包括终止 null 字符。如果长度大于缓冲区的大小，则返回值是保存路径所需的缓冲区大小，包括终止 null 字符。

如果函数失败，则返回值为零。若要获取扩展的错误信息，请调用 GetLastError。

应用程序不应在系统目录中创建文件。如果用户运行的是操作系统的共享版本，则应用程序对系统目录没有写入访问权限。

有关示例，请参阅获取系统信息。

注意

sysinfoapi.h 标头将 GetSystemDirectory 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求	价值
最低支持的客户端	Windows 2000 Professional [桌面应用 \|UWP 应用]
支持的最低服务器	Windows 2000 Server [桌面应用 \|UWP 应用]
目标平台	窗户
标头	sysinfoapi.h （包括 Windows.h）
库	Kernel32.lib
DLL	Kernel32.dll