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