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

Artigo
08/23/2023

Recupera as regras de inclusão e exclusão armazenadas atualmente em um objeto FhConfigMgr .

Observação

O IFhConfigMgr foi preterido e pode ser alterado ou indisponível em versões futuras.

Sintaxe

HRESULT GetIncludeExcludeRules(
  [in]  BOOL                       Include,
  [in]  FH_PROTECTED_ITEM_CATEGORY Category,
  [out] IFhScopeIterator           **Iterator
);

Parâmetros

[in] Include

Se definido como TRUE, as regras de inclusão serão retornadas. Se definido como FALSE, as regras de exclusão serão retornadas.

[in] Category

Um FH_PROTECTED_ITEM_CATEGORY valor de enumeração que especifica o tipo das regras de inclusão ou exclusão.

[out] Iterator

Recebe um ponteiro de interface IFhScopeIterator que pode ser usado para enumerar as regras na categoria solicitada.

Valor retornado

S_OK sobre o êxito ou um HRESULT malsucedido em caso de falha. Possíveis valores HRESULT malsucedidos incluem valores definidos no arquivo de cabeçalho FhErrors.h.

Comentários

O escopo de proteção do Histórico de Arquivos é o conjunto de arquivos cujo backup é feito por esse recurso. Ele contém regras de inclusão e regras de exclusão. As regras de inclusão especificam os arquivos e pastas incluídos. As regras de exclusão especificam os arquivos e pastas excluídos.

O escopo de proteção padrão inclui todas as pastas de todas as bibliotecas de usuário e as pastas Contatos, Área de Trabalho e Favoritos.

Você pode modificar o escopo de proteção do Histórico de Arquivos adicionando regras de exclusão para reduzir o escopo de proteção do Histórico de Arquivos sem remover pastas de bibliotecas de usuários.

As regras de exclusão têm precedência sobre as regras de inclusão. Em outras palavras, se uma regra de inclusão entrar em conflito com uma regra de exclusão, o recurso Histórico de Arquivos seguirá a regra de exclusão.

O método IFhConfigMgr::AddRemoveExcludeRule pode ser usado para adicionar ou remover regras de exclusão. Ele não pode ser usado para modificar as regras de inclusão.

Requisitos


Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	fhcfg.h