Функция GetSystemDirectoryA (sysinfoapi.h)

  • Статья

Извлекает путь к системной папке. Системный каталог содержит системные файлы, такие как динамические библиотеки и драйверы.

Эта функция предоставляется в первую очередь для обеспечения совместимости. Приложения должны хранить код в папке Program Files, а постоянные данные — в папке Application Data в профиле пользователя. Дополнительные сведения см. в разделе ShGetFolderPath.

Синтаксис

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

Параметры

[out] lpBuffer

Указатель на буфер для получения пути. Этот путь не заканчивается обратной косой чертой, если системный каталог не является корневым каталогом. Например, если системный каталог называется Windows\System32 на диске C, путь к системной папке, полученной этой функцией, — C:\Windows\System32.

[in] uSize

Максимальный размер буфера в TCHAR.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение — это длина строки, скопированной в буфер, в TCHARs, не включая завершающий символ NULL. Если длина превышает размер буфера, возвращаемое значение — это размер буфера, необходимый для хранения пути, включая завершающий символ NULL.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Приложения не должны создавать файлы в системном каталоге. Если пользователь использует общую версию операционной системы, приложение не имеет доступа на запись в системный каталог.

Примеры

Пример см. в разделе Получение сведений о системе.

Примечание

Заголовок sysinfoapi.h определяет GetSystemDirectory как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header sysinfoapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

GetCurrentDirectory

GetWindowsDirectory

SetCurrentDirectory

Системные информационные функции