SetFileAttributesFromAppW 函数 (fileapifromapp.h)

设置文件或目录的属性。 此函数的行为与 SetFileAttributes 相同，只不过此函数遵循通用 Windows 平台应用安全模型。

语法

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

参数

lpFileName

要设置其属性的文件的名称。

有关在不附加“\？\？\”的情况下选择退出 MAX_PATH 限制的信息，请参阅 命名文件、路径和命名空间 的“最大路径长度限制”部分了解详细信息。

dwFileAttributes

为文件设置的文件属性。

此参数可以是一个或多个值，使用按位 OR 运算符组合。 但是，所有其他值都替代 FILE_ATTRIBUTE_NORMAL。

此函数并非支持所有属性。

下面是支持的属性值列表。

Value	含义
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