Share via

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

  • Artigo

Adiciona uma regra de exclusão à lista de exclusão ou remove uma regra da lista.

Observação

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

Sintaxe

HRESULT AddRemoveExcludeRule(
  [in] BOOL                       Add,
  [in] FH_PROTECTED_ITEM_CATEGORY Category,
  [in] BSTR                       Item
);

Parâmetros

[in] Add

Se esse parâmetro for TRUE, uma nova regra de exclusão será adicionada. Se for definido como FALSE, uma regra de exclusão existente será removida.

[in] Category

Especifica o tipo da regra de exclusão. Consulte a enumeração FH_PROTECTED_ITEM_CATEGORY para obter valores possíveis.

[in] Item

O caminho da pasta ou nome da biblioteca ou GUID do item ao qual a regra de exclusão se aplica.

Retornar valor

S_OK em caso de êxito ou um valor 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 da proteção do Histórico de Arquivos é o conjunto de arquivos com backup do recurso Histórico de Arquivos. 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.

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.

Para reduzir o escopo de proteção, use o IFhConfigMgr::AddRemoveExcludeRule para adicionar regras de exclusão.

Esse método pode ser usado para adicionar ou remover regras de exclusão. Ele não pode ser usado para modificar regras de inclusão.

As bibliotecas de usuários podem ser enumeradas chamando a função SHGetKnownFolderItem e os métodos das interfaces IShellItem e IEnumShellItems .

As pastas e bibliotecas padrão são especificadas por um GUID, prefixado com um asterisco. Por exemplo, *a990ae9f-a03b-4e80-94bc-9912d7504104 especifica a biblioteca Imagens. Para obter uma lista de pastas e bibliotecas padrão e seus GUIDs, consulte a documentação KNOWNFOLDERID .

As bibliotecas personalizadas são especificadas pelo nome. As pastas são especificadas pelo caminho completo (por exemplo, C:\Users\Public\Videos).

Requisitos

Requisito Valor
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

Confira também

FH_PROTECTED_ITEM_CATEGORY

FhConfigMgr

IFhConfigMgr

IFhConfigMgr::GetIncludeExcludeRules