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 |