Função DecryptFileA (winbase.h)
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_ATTRIBUTESe SYNCHRONIZE. Para obter mais informações, consulte de Segurança de Arquivos e Direitos de Acesso.
dwReserved
Reservado; deve ser zero.
Valor de retorno
Se a função for bem-sucedida, o valor retornado não será zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Observações
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 GetLastError retornará 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, no Windows Server 2012 e posterior, essa função tem suporte nas tecnologias a seguir.
| Tecnologia | Suportado |
|---|---|
| Protocolo SMB (Bloco de Mensagens do Servidor) 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 de Cluster (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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winbase.h (inclua Windows.h) |
| biblioteca | Advapi32.lib |
| de DLL |
Advapi32.dll |
| conjunto de API | ext-ms-win-advapi32-encryptedfile-l1-1-0 (introduzido no Windows 8) |