Функция PathIsSystemFolderA (shlwapi.h)

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

Синтаксис

BOOL PathIsSystemFolderA(
  [in, optional] LPCSTR pszPath,
  [in]           DWORD  dwAttrb
);

Параметры

[in, optional] pszPath

Тип: LPCTSTR

Указатель на строку, завершающуюся значением NULL, с максимальной длиной MAX_PATH, содержащую имя существующей папки. Атрибуты для этой папки будут извлечены и сравниваются с атрибутами, определяющими системную папку. Если эта папка содержит атрибуты, чтобы сделать ее системной, функция возвращает ненулевое значение. Если это значение равно NULL, эта функция определяет, соответствуют ли атрибуты, переданные в dwAttrb , к системной папке.

[in] dwAttrb

Тип: DWORD

Атрибуты файла для сравнения. Используется, только если pszPath имеет значение NULL. В этом случае атрибуты, передаваемые в этом значении, сравниваются с атрибутами, которые квалифицируют папку как системную папку. Если атрибутов достаточно, чтобы сделать папку системной, эта функция возвращает ненулевое значение. Эти атрибуты являются атрибутами, возвращаемыми из GetFileAttributes.

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

Тип: BOOL

Возвращает ненулевое значение, если pszPath или dwAttrb представляют системную папку, или ноль в противном случае.

Комментарии

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlwapi.h
Библиотека	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)