Méthode IFhConfigMgr ::AddRemoveExcludeRule (fhcfg.h)
Ajoute une règle d’exclusion à la liste d’exclusions ou supprime une règle de la liste.
Notes
IFhConfigMgr est déconseillé et peut être modifié ou indisponible dans les versions ultérieures.
Syntaxe
HRESULT AddRemoveExcludeRule(
[in] BOOL Add,
[in] FH_PROTECTED_ITEM_CATEGORY Category,
[in] BSTR Item
);
Paramètres
[in] Add
Si ce paramètre a la valeur TRUE, une nouvelle règle d’exclusion est ajoutée. S’il est défini sur FALSE, une règle d’exclusion existante est supprimée.
[in] Category
Spécifie le type de la règle d’exclusion. Consultez l’énumération FH_PROTECTED_ITEM_CATEGORY pour connaître les valeurs possibles.
[in] Item
Chemin d’accès au dossier ou nom de la bibliothèque ou GUID de l’élément auquel la règle d’exclusion s’applique.
Valeur retournée
S_OK sur la réussite ou une valeur HRESULT infructueuse en cas d’échec. Les valeurs HRESULT potentiellement infructueuses incluent les valeurs définies dans le fichier d’en-tête FhErrors.h.
Remarques
L’étendue de protection de l’historique des fichiers est l’ensemble de fichiers sauvegardés par la fonctionnalité Historique des fichiers. Il contient des règles d’inclusion et des règles d’exclusion. Les règles d’inclusion spécifient les fichiers et dossiers inclus. Les règles d’exclusion spécifient les fichiers et dossiers qui sont exclus.
L’étendue de protection par défaut inclut tous les dossiers de toutes les bibliothèques utilisateur et les dossiers Contacts, Desktop et Favoris.
Les règles d’exclusion sont prioritaires sur les règles d’inclusion. En d’autres termes, si une règle d’inclusion est en conflit avec une règle d’exclusion, la fonctionnalité Historique des fichiers suit la règle d’exclusion.
Pour réduire l’étendue de protection, utilisez IFhConfigMgr ::AddRemoveExcludeRule pour ajouter des règles d’exclusion.
Cette méthode peut être utilisée pour ajouter ou supprimer des règles d’exclusion. Il ne peut pas être utilisé pour modifier les règles d’inclusion.
Vous pouvez énumérer les bibliothèques utilisateur en appelant la fonction SHGetKnownFolderItem et les méthodes des interfaces IShellItem et IEnumShellItems .
Les dossiers et bibliothèques standard sont spécifiés par un GUID, précédé d’un astérisque. Par exemple, *a990ae9f-a03b-4e80-94bc-9912d7504104 spécifie la bibliothèque Images. Pour obtenir la liste des dossiers et bibliothèques standard et leurs GUID, consultez la documentation KNOWNFOLDERID .
Les bibliothèques personnalisées sont spécifiées par nom. Les dossiers sont spécifiés par leur chemin complet (par exemple, C :\Users\Public\Videos).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | fhcfg.h |