Función DecryptFileA (winbase.h)

  • Artículo

Descifra un archivo o directorio cifrados.

Sintaxis

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

Parámetros

[in] lpFileName

Nombre del archivo o directorio que se va a descifrar.

El autor de la llamada debe tener los derechos de acceso FILE_READ_DATA, FILE_WRITE_DATA, FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTES y SYNCHRONIZE . Para obtener más información, vea Seguridad de archivos y derechos de acceso.

dwReserved

Reservados; debe ser cero.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función DecryptFile requiere acceso exclusivo al archivo que se está descifrando y producirá un error si otro proceso usa el archivo. Si el archivo no está cifrado, DecryptFile simplemente devuelve un valor distinto de cero, lo que indica que se ha realizado correctamente.

Si lpFileName especifica un archivo de solo lectura, se produce un error en la función y GetLastError devuelve ERROR_FILE_READ_ONLY. Si lpFileName especifica un directorio que contiene un archivo de solo lectura, las funciones se realizan correctamente, pero el directorio no se descifra.

En Windows 8, Windows Server 2012 y versiones posteriores, esta función es compatible con las siguientes tecnologías.

Tecnología Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0 Sí
Conmutación por error transparente (TFO) de SMB 3.0 No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) No
Sistema de archivos de Volumen compartido de clúster (CsvFS) No
Sistema de archivos resistente a errores (ReFS) No
 

SMB 3.0 no admite EFS en recursos compartidos con capacidad de disponibilidad continua.

Nota

El encabezado winbase.h define DecryptFile como un alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluya Windows.h)
Library Advapi32.lib
Archivo DLL Advapi32.dll
Conjunto de API ext-ms-win-advapi32-encryptedfile-l1-1-0 (introducido en Windows 8)

Consulte también

CreateFile

EncryptFile

Cifrado de archivos

Funciones de administración de archivos