Função EncryptionDisable (winefs.h)

Artigo
08/27/2023

Desabilita ou habilita a criptografia do diretório especificado e dos arquivos que estão nele. Ele não afeta a criptografia de subdiretórios abaixo do diretório indicado.

Sintaxe

BOOL EncryptionDisable(
  [in] LPCWSTR DirPath,
  [in] BOOL    Disable
);

Parâmetros

[in] DirPath

O nome do diretório para o qual habilitar ou desabilitar a criptografia.

[in] Disable

Indica se é necessário desabilitar a criptografia (TRUE) ou habilitá-la (FALSE).

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Em circunstâncias normais, EncryptFile não criptografará arquivos e diretórios com o conjunto de atributos FILE_ATTRIBUTE_SYSTEM. É possível substituir o atributo FILE_ATTRIBUTE_SYSTEM e criptografar arquivos. Além disso, se um arquivo ou diretório for marcado com o atributo FILE_ATTRIBUTE_SYSTEM, ele normalmente será invisível para o usuário em listagens de diretório e janelas de diretório do Windows Explorer. EncryptionDisable desabilita a criptografia de diretórios e arquivos. Isso não afeta a visibilidade dos arquivos com o conjunto de atributos FILE_ATTRIBUTE_SYSTEM .

Se TRUE for passado, EncryptionDisable gravará o seguinte no arquivo Desktop.ini no diretório (criando-o, se necessário):

[Encryption]
Disable=1

Se a seção já existir, mas Desabilitar estiver definida como 0, ela será definida como 1.

Depois disso, EncryptFile falhará no diretório e nos arquivos nele, e o código retornado por GetLastError será ERROR_DIR_EFS_DISALLOWED. Essa função não afeta a criptografia de subdiretórios dentro do diretório fornecido.

O usuário também pode adicionar ou editar manualmente as linhas acima no arquivo Desktop.ini e produzir o mesmo efeito.

EncryptionDisable afeta apenas FileEncryptionStatus e EncryptFile. Depois que o diretório for criptografado, todos os novos arquivos e novos subdiretórios criados sem o atributo FILE_ATTRIBUTE_SYSTEM serão criptografados.

Se FALSE for passado, EncryptionDisable gravará o seguinte no arquivo Desktop.ini:

[Encryption]
Disable=0

Isso significa que a criptografia de arquivo é permitida nos arquivos nesse diretório.

Se você tentar usar EncryptionDisable para definir o diretório para o estado em que ele já está, a função terá êxito, mas não terá efeito.

Se você tentar usar EncryptionDisable para desabilitar ou habilitar a criptografia em um arquivo, a tentativa falhará.

No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.

Tecnologia	Com suporte
Protocolo SMB (SMB) 3.0	Sim
TFO (Failover transparente) do SMB 3.0	Não
SMB 3.0 com compartilhamentos de arquivos de expansão (SO)	Não
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS)	Não
ReFS (Sistema de Arquivos Resiliente)	Não

O SMB 3.0 não dá suporte ao EFS em compartilhamentos com capacidade de disponibilidade contínua.

Requisitos


Cliente mínimo com suporte	Windows XP Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winefs.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll