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 函数以及 IShellItemIEnumShellItems 接口的方法来枚举用户库。

标准文件夹和库由 GUID 指定,前缀为星号。 例如,*a990ae9f-a03b-4e80-94bc-9912d7504104 指定图片库。 有关标准文件夹和库及其 GUID 的列表,请参阅 KNOWNFOLDERID 文档。

自定义库按名称指定。 文件夹由其完整路径 (指定,例如 C:\Users\Public\Videos) 。

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 fhcfg.h

另请参阅

FH_PROTECTED_ITEM_CATEGORY

FhConfigMgr

IFhConfigMgr

IFhConfigMgr::GetIncludeExcludeRules