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

Статья
11/20/2024

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

Синтаксис

BOOL PathIsSystemFolderW(
  [in, optional] LPCWSTR pszPath,
  [in]           DWORD   dwAttrb
);

Параметры

[in, optional] pszPath

Тип: LPCTSTR

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

[in] dwAttrb

Тип: DWORD

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

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

Тип: BOOL

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)

Поделиться через