Metodo IFhConfigMgr::AddRemoveExcludeRule (fhcfg.h)
Aggiunge una regola di esclusione all'elenco di esclusione o rimuove una regola dall'elenco.
Nota
IFhConfigMgr è deprecato e può essere modificato o non disponibile nelle versioni future.
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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | fhcfg.h |