# sys.featureFlags 库模块帮助文档

[» 使用指南](https://www.aardio.com/zh-cn/docs/library/sys/featureFlags/index.html)

## sys.featureFlags 成员列表 <a id="sys.featureFlags" href="#sys.featureFlags">&#x23;</a>

Windows 10 2004（Build 18963）及以后版本的 Windows Feature Management API 封装。  

用于查询、启用、禁用或恢复 Windows A/B 灰度特性与隐藏功能；例如新版右键菜单、任务栏实验功能、文件资源管理器实验功能等。  

修改配置需要管理员权限。默认写入 Runtime 存储区；Boot 存储区在核心库中只读。  

注意：Feature ID 的含义、可用版本和副作用由 Windows 版本决定，不要把随机 ID 当作通用开关。  

本库直接调用 Windows ntdll.dll，不依赖外部可执行文件。

### sys.featureFlags.query(60813048) <a id="sys.featureFlags.query" href="#sys.featureFlags.query">&#x23;</a>
查询单个 Feature ID，返回特性信息、changeStamp；失败返回 null,error,status  
queryMany([60813048,49453572]) = 批量查询指定 Feature ID  
queryAll() = 枚举 Runtime 存储区内所有已配置特性  
queryAll(configurationType.boot) = 枚举 Boot 存储区内所有已配置特性  
queryChangeStamp() = 查询 Runtime Feature Configuration 的全局变更戳  
enable([60813048,49453572],{configType=configurationType.runtime}) = 以 User 优先级启用一组特性  
disable([60813048,49453572]) = 以 User 优先级禁用一组特性  
reset([60813048,49453572]) = 删除 User 优先级覆盖，恢复 Windows 默认/服务下发状态  
set([{featureId=60813048;enabledState=state.enabled;operation=operation.featureState}]) = 按完整更新结构批量写入 Runtime 配置  
Boot 配置 = 可通过 query/queryMany/queryAll 读取；核心写入接口不修改 Boot 存储