Функция SetFileAttributesFromAppW (fileapifromapp.h)

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

Синтаксис

WINSTORAGEAPI BOOL SetFileAttributesFromAppW(
  LPCWSTR lpFileName,
  DWORD   dwFileAttributes
) noexcept;

Параметры

lpFileName

Имя файла, атрибуты которого необходимо задать.

Сведения об отказе от ограничения MAX_PATH без добавления "\?\" см. в разделе "Ограничение максимальной длины пути" статьи Именование файлов, путей и пространств имен .

dwFileAttributes

Атрибуты файла, которые необходимо задать для файла.

Этот параметр может быть одним или несколькими значениями, объединенными с помощью побитового оператора ИЛИ. Однако все остальные значения переопределяют FILE_ATTRIBUTE_NORMAL.

Эта функция поддерживает не все атрибуты.

Ниже приведен список поддерживаемых значений атрибутов.

Значение	Значение
FILE_ATTRIBUTE_ARCHIVE 32 (0x20)	Файл или каталог, который является архивным файлом или каталогом. Приложения обычно используют этот атрибут для пометки файлов для резервного копирования или удаления.
FILE_ATTRIBUTE_HIDDEN 2 (0x2)	Файл или каталог скрыты. Он не включается в обычный список каталогов.
FILE_ATTRIBUTE_NORMAL 128 (0x80)	Файл, для которых не заданы другие атрибуты. Этот атрибут действителен только при использовании отдельно.
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 8192 (0x2000)	Файл или каталог не должны индексироваться службой индексирования содержимого.
FILE_ATTRIBUTE_OFFLINE 4096 (0x1000)	Данные файла доступны не сразу. Этот атрибут указывает, что данные файла физически перемещаются в автономное хранилище. Этот атрибут используется удаленным хранилищем, которое является программным обеспечением для управления иерархическим хранилищем. Приложения не должны произвольно изменять этот атрибут.
FILE_ATTRIBUTE_READONLY 1 (0x1)	Файл, доступный только для чтения. Приложения могут читать файл, но не могут записывать в него или удалять его. Этот атрибут не учитывается в каталогах.
FILE_ATTRIBUTE_SYSTEM 4 (0x4)	Файл или каталог, часть или который используется исключительно операционной системой.
FILE_ATTRIBUTE_TEMPORARY 256 (0x100)	Файл, используемый для временного хранения. Если доступно достаточно памяти кэша, файловые системы избегают записи данных обратно в хранилище, так как обычно приложение удаляет временный файл после закрытия дескриптора. В этом сценарии система может полностью избежать записи данных. В противном случае данные записываются после закрытия дескриптора.

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

Если функция выполняется успешно, возвращается ненулевое значение.

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

Требования

Минимальная версия клиента	Windows 10 версии 1803
Верхняя часть	fileapifromapp.h