IFhConfigMgr::AddRemoveExcludeRule-Methode (fhcfg.h)
Fügt der Ausschlussliste eine Ausschlussregel hinzu oder entfernt eine Regel aus der Liste.
Hinweis
IFhConfigMgr ist veraltet und kann in zukünftigen Versionen geändert oder nicht mehr verfügbar sein.
Syntax
HRESULT AddRemoveExcludeRule(
[in] BOOL Add,
[in] FH_PROTECTED_ITEM_CATEGORY Category,
[in] BSTR Item
);
Parameter
[in] Add
Wenn dieser Parameter TRUE ist, wird eine neue Ausschlussregel hinzugefügt. Wenn sie auf FALSE festgelegt ist, wird eine vorhandene Ausschlussregel entfernt.
[in] Category
Gibt den Typ der Ausschlussregel an. Mögliche Werte finden Sie in der FH_PROTECTED_ITEM_CATEGORY-Enumeration .
[in] Item
Der Ordnerpfad, der Bibliotheksname oder die GUID des Elements, auf das die Ausschlussregel angewendet wird.
Rückgabewert
S_OK bei Erfolg oder einem nicht erfolgreichen HRESULT-Wert bei Einem Fehler. Mögliche nicht erfolgreiche HRESULT-Werte umfassen Werte, die in der FhErrors.h-Headerdatei definiert sind.
Hinweise
Der Schutzbereich Dateiverlauf ist der Satz von Dateien, die durch das Feature Dateiverlauf gesichert werden. Sie enthält Einschluss- und Ausschlussregeln. Einschlussregeln geben die enthaltenen Dateien und Ordner an. Ausschlussregeln geben die ausgeschlossenen Dateien und Ordner an.
Der Standardschutzbereich umfasst alle Ordner aus allen Benutzerbibliotheken sowie die Ordner Kontakte, Desktop und Favoriten.
Ausschlussregeln haben Vorrang vor Einschlussregeln. Anders ausgedrückt: Wenn eine Einschlussregel mit einer Ausschlussregel in Konflikt tritt, folgt das Feature Dateiverlauf der Ausschlussregel.
Um den Schutzbereich zu verringern, verwenden Sie IFhConfigMgr::AddRemoveExcludeRule , um Ausschlussregeln hinzuzufügen.
Diese Methode kann verwendet werden, um Ausschlussregeln hinzuzufügen oder zu entfernen. Sie kann nicht zum Ändern von Einschlussregeln verwendet werden.
Benutzerbibliotheken können durch Aufrufen der SHGetKnownFolderItem-Funktion und der Methoden der IShellItem- und IEnumShellItems-Schnittstellen aufgezählt werden.
Standardordner und -bibliotheken werden durch eine GUID mit einem Sternchen als Präfix angegeben. *a990ae9f-a03b-4e80-94bc-9912d7504104 gibt beispielsweise die Bildbibliothek an. Eine Liste der Standardordner und -bibliotheken und deren GUIDs finden Sie in der KNOWNFOLDERID-Dokumentation .
Benutzerdefinierte Bibliotheken werden anhand des Namens angegeben. Ordner werden durch ihren vollständigen Pfad angegeben (z. B. C:\Benutzer\Public\Videos).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | fhcfg.h |