Função DecryptFileA (winbase.h)

  • Artigo

Descriptografa um arquivo ou diretório criptografado.

Sintaxe

BOOL DecryptFileA(
  [in] LPCSTR lpFileName,
       DWORD  dwReserved
);

Parâmetros

[in] lpFileName

O nome do arquivo ou diretório a ser descriptografado.

O chamador deve ter os direitos de acesso FILE_READ_DATA, FILE_WRITE_DATA, FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTES e SYNCHRONIZE . Para obter mais informações, consulte Segurança de arquivos e Direitos de Acesso.

dwReserved

Reservados; deve ser zero.

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

A função DecryptFile requer acesso exclusivo ao arquivo que está sendo descriptografado e falhará se outro processo estiver usando o arquivo. Se o arquivo não estiver criptografado, DecryptFile simplesmente retornará um valor diferente de zero, o que indica êxito.

Se lpFileName especificar um arquivo somente leitura, a função falhará e GetLastErrorretornará ERROR_FILE_READ_ONLY. Se lpFileName especificar um diretório que contém um arquivo somente leitura, as funções serão bem-sucedidas, mas o diretório não será descriptografado.

No Windows 8, Windows Server 2012 e posteriores, essa função tem suporte nas 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 funcionalidade de disponibilidade contínua.

Observação

O cabeçalho winbase.h define DecryptFile como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows XP [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 winbase.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll
Conjunto de APIs ext-ms-win-advapi32-encryptedfile-l1-1-0 (introduzido no Windows 8)

Confira também

CreateFile

EncryptFile

Criptografia de Arquivo

Funções de gerenciamento de arquivos