Método IFhConfigMgr::AddRemoveExcludeRule (fhcfg.h)
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 |