Metodo IFhConfigMgr::AddRemoveExcludeRule (fhcfg.h)

Aggiunge una regola di esclusione all'elenco di esclusione o rimuove una regola dall'elenco.

Sintassi

HRESULT AddRemoveExcludeRule(
  [in] BOOL                       Add,
  [in] FH_PROTECTED_ITEM_CATEGORY Category,
  [in] BSTR                       Item
);

Parametri

[in] Add

Se questo parametro è TRUE, viene aggiunta una nuova regola di esclusione. Se è impostato su FALSE, viene rimossa una regola di esclusione esistente.

[in] Category

Specifica il tipo della regola di esclusione. Per i valori possibili, vedere l'enumerazione FH_PROTECTED_ITEM_CATEGORY .

[in] Item

Percorso della cartella o nome della libreria o GUID dell'elemento a cui si applica la regola di esclusione.

Valore restituito

S_OK sull'esito positivo o su un valore HRESULT non riuscito in caso di errore. I valori HRESULT possibili non riusciti includono valori definiti nel file di intestazione FhErrors.h.

Commenti

L'ambito protezione cronologia file è il set di file che vengono sottoposti a backup dalla funzionalità Cronologia file. Contiene regole di inclusione e regole di esclusione. Le regole di inclusione specificano i file e le cartelle inclusi. Le regole di esclusione specificano i file e le cartelle esclusi.

L'ambito di protezione predefinito include tutte le cartelle di tutte le librerie utente e le cartelle Contatti, Desktop e Preferiti.

Le regole di esclusione hanno la precedenza sulle regole di inclusione. In altre parole, se una regola di inclusione è in conflitto con una regola di esclusione, la funzionalità Cronologia file segue la regola di esclusione.

Per ridurre l'ambito di protezione, usare IFhConfigMgr::AddRemoveExcludeRule per aggiungere regole di esclusione.

Questo metodo può essere usato per aggiungere o rimuovere regole di esclusione. Non può essere usato per modificare le regole di inclusione.

Le librerie utente possono essere enumerate chiamando la funzione SHGetKnownFolderItem e i metodi delle interfacce IShellItem e IEnumShellItems.

Le cartelle e le librerie standard vengono specificate da un GUID, preceduto da un asterisco. Ad esempio, *a990ae9f-a03b-4e80-94bc-9912d7504104 specifica la libreria Immagini. Per un elenco di cartelle e librerie standard e relativi GUID, vedere la documentazione DI KNOWNFOLDERID .

Le librerie personalizzate vengono specificate in base al nome. Le cartelle vengono specificate dal percorso completo, ad esempio C:\Users\Public\Videos.

Requisiti

Vedi anche

FH_PROTECTED_ITEM_CATEGORY

FhConfigMgr

IFhConfigMgr

IFhConfigMgr::GetIncludeExcludeRules