Функция GetSystemDirectoryW (sysinfoapi.h)
Извлекает путь системного каталога. Системный каталог содержит системные файлы, такие как библиотеки и драйверы динамического канала.
Эта функция предоставляется в первую очередь для обеспечения совместимости. Приложения должны хранить код в папке Program Files и постоянные данные в папке "Данные приложения" в профиле пользователя. Дополнительные сведения см. в ShGetFolderPath.
Синтаксис
UINT GetSystemDirectoryW(
[out] LPWSTR lpBuffer,
[in] UINT uSize
);
Параметры
[out] lpBuffer
Указатель на буфер для получения пути. Этот путь не заканчивается обратной косой чертой, если системный каталог не является корневым каталогом. Например, если системный каталог называется Windows\System32 на диске C, путь системного каталога, полученного этой функцией, — C:\Windows\System32.
[in] uSize
Максимальный размер буфера в TCHARs.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение имеет длину в TCHARs, строки, скопированной в буфер, а не включающее завершающий символ NULL. Если длина превышает размер буфера, возвращаемое значение — это размер буфера, необходимый для хранения пути, включая завершающий символ NULL.
Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Приложения не должны создавать файлы в системном каталоге. Если пользователь работает с общей версией операционной системы, приложение не имеет доступа к системным каталогу.
Примеры
Пример см. в получения сведений о системе.
Заметка
Заголовок sysinfoapi.h определяет GetSystemDirectory как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [классические приложения | Приложения UWP] |
| минимальный поддерживаемый сервер | Windows 2000 Server [классические приложения | Приложения UWP] |
| целевая платформа | Виндоус |
| заголовка | sysinfoapi.h (включая Windows.h) |
| библиотеки |
Kernel32.lib |
| DLL | Kernel32.dll |