IFhConfigMgr::AddRemoveExcludeRule 方法 (fhcfg.h)
将排除规则添加到排除列表或从列表中删除规则。
注意
IFhConfigMgr 已弃用,将来的版本可能会更改或不可用。
语法
HRESULT AddRemoveExcludeRule(
[in] BOOL Add,
[in] FH_PROTECTED_ITEM_CATEGORY Category,
[in] BSTR Item
);
参数
[in] Add
如果此参数为 TRUE,则会添加新的排除规则。 如果设置为 FALSE,则会删除现有的排除规则。
[in] Category
指定排除规则的类型。 有关可能的值 ,请参阅FH_PROTECTED_ITEM_CATEGORY 枚举。
[in] Item
应用排除规则的项的文件夹路径、库名称或 GUID。
返回值
成功时S_OK ,失败时为不成功的 HRESULT 值。 可能不成功的 HRESULT 值包括 FhErrors.h 头文件中定义的值。
注解
文件历史记录保护范围是由文件历史记录功能备份的文件集。 它包含包含规则和排除规则。 包含规则指定包含的文件和文件夹。 排除规则指定排除的文件和文件夹。
默认保护范围包括所有用户库以及“联系人”、“桌面”和“收藏夹”文件夹中的所有文件夹。
排除规则优先于包含规则。 换句话说,如果包含规则与排除规则冲突,则文件历史记录功能将遵循排除规则。
若要缩小保护范围,请使用 IFhConfigMgr::AddRemoveExcludeRule 添加排除规则。
此方法可用于添加或删除排除规则。 它不能用于修改包含规则。
可以通过调用 SHGetKnownFolderItem 函数以及 IShellItem 和 IEnumShellItems 接口的方法来枚举用户库。
标准文件夹和库由 GUID 指定,前缀为星号。 例如,*a990ae9f-a03b-4e80-94bc-9912d7504104 指定图片库。 有关标准文件夹和库及其 GUID 的列表,请参阅 KNOWNFOLDERID 文档。
自定义库按名称指定。 文件夹由其完整路径 (指定,例如 C:\Users\Public\Videos) 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | fhcfg.h |