Метод IFhConfigMgr::AddRemoveExcludeRule (fhcfg.h)

Добавляет правило исключения в список исключений или удаляет правило из списка.

Синтаксис

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).

Требования

См. также раздел

FH_PROTECTED_ITEM_CATEGORY

FhConfigMgr

IFhConfigMgr

IFhConfigMgr::GetIncludeExcludeRules