Método IFhConfigMgr::AddRemoveExcludeRule (fhcfg.h)

  • Artículo

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

Consulte también

FH_PROTECTED_ITEM_CATEGORY

FhConfigMgr

IFhConfigMgr

IFhConfigMgr::GetIncludeExcludeRules