Função EncryptionDisable (winefs.h)
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 |
Confira também
Constantes de atributo de arquivo