Método IFhConfigMgr::AddRemoveExcludeRule (fhcfg.h)
Agrega una regla de exclusión a la lista de exclusión o quita una regla de la lista.
Nota
IFhConfigMgr está en desuso y puede modificarse o no estar disponible en futuras versiones.
Sintaxis
HRESULT AddRemoveExcludeRule(
[in] BOOL Add,
[in] FH_PROTECTED_ITEM_CATEGORY Category,
[in] BSTR Item
);
Parámetros
[in] Add
Si este parámetro es TRUE, se agrega una nueva regla de exclusión. Si se establece en FALSE, se quita una regla de exclusión existente.
[in] Category
Especifica el tipo de la regla de exclusión. Consulte la enumeración FH_PROTECTED_ITEM_CATEGORY para ver los valores posibles.
[in] Item
Ruta de acceso de carpeta o nombre de biblioteca o GUID del elemento al que se aplica la regla de exclusión.
Valor devuelto
S_OK si se ha realizado correctamente o un valor HRESULT incorrecto en caso de error. Los posibles valores HRESULT incorrectos incluyen los valores definidos en el archivo de encabezado FhErrors.h.
Comentarios
El ámbito de protección del historial de archivos es el conjunto de archivos de los que realiza una copia de seguridad la característica Historial de archivos. Contiene reglas de inclusión y reglas de exclusión. Las reglas de inclusión especifican los archivos y carpetas que se incluyen. Las reglas de exclusión especifican los archivos y carpetas que se excluyen.
El ámbito de protección predeterminado incluye todas las carpetas de todas las bibliotecas de usuario y las carpetas Contactos, Escritorio y Favoritos.
Las reglas de exclusión tienen prioridad sobre las reglas de inclusión. En otras palabras, si una regla de inclusión entra en conflicto con una regla de exclusión, la característica Historial de archivos sigue la regla de exclusión.
Para reducir el ámbito de protección, use IFhConfigMgr::AddRemoveExcludeRule para agregar reglas de exclusión.
Este método se puede usar para agregar o quitar reglas de exclusión. No se puede usar para modificar las reglas de inclusión.
Las bibliotecas de usuario se pueden enumerar llamando a la función SHGetKnownFolderItem y los métodos de las interfaces IShellItem e IEnumShellItems .
Las carpetas y bibliotecas estándar se especifican mediante un GUID, con el prefijo asterisco. Por ejemplo, *a990ae9f-a03b-4e80-94bc-9912d7504104 especifica la biblioteca Pictures. Para obtener una lista de las carpetas y bibliotecas estándar y sus GUID, consulte la documentación de KNOWNFOLDERID .
Las bibliotecas personalizadas se especifican por nombre. Las carpetas se especifican mediante su ruta de acceso completa (por ejemplo, C:\Users\Public\Videos).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | fhcfg.h |