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