Función ReadEncryptedFileRaw (winbase.h)

Artículo
03/03/2024

Realiza una copia de seguridad (exporta) los archivos cifrados. Se trata de un grupo de funciones del Sistema de archivos cifrados (EFS) que está pensada para implementar la funcionalidad de copia de seguridad y restauración, a la vez que mantiene los archivos en su estado cifrado.

Sintaxis

DWORD ReadEncryptedFileRaw(
  [in]           PFE_EXPORT_FUNC pfExportCallback,
  [in, optional] PVOID           pvCallbackContext,
  [in]           PVOID           pvContext
);

Parámetros

[in] pfExportCallback

Puntero a la función de devolución de llamada de exportación. El sistema llama a la función de devolución de llamada varias veces, cada vez que pasa un bloque de datos del archivo a la función de devolución de llamada hasta que se haya leído todo el archivo. Para obtener más información, vea ExportCallback.

[in, optional] pvCallbackContext

Puntero a un bloque de contexto definido por la aplicación y asignado. El sistema pasa este puntero a la función de devolución de llamada como parámetro para que la función de devolución de llamada pueda tener acceso a datos específicos de la aplicación. Puede ser una estructura y puede contener los datos que necesite la aplicación, como el identificador del archivo que contendrá la copia de seguridad del archivo cifrado.

[in] pvContext

Puntero a un bloque de contexto definido por el sistema. La función OpenEncryptedFileRaw devuelve el bloque de contexto. No la modifique.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, devuelve un código de error distinto de cero definido en WinError.h. Puede usar FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para obtener una descripción de texto genérica del error.

Comentarios

El archivo de copia de seguridad no se descifra; se realiza una copia de seguridad en su estado cifrado.

Para realizar una copia de seguridad de un archivo cifrado, llame a OpenEncryptedFileRaw para abrir el archivo. A continuación, llame a ReadEncryptedFileRaw y pase la dirección de una función de devolución de llamada de exportación definida por la aplicación. El sistema llama a esta función de devolución de llamada varias veces hasta que se haya leído y realizado una copia de seguridad del contenido completo del archivo. Una vez completada la copia de seguridad, llame a CloseEncryptedFileRaw para liberar recursos y cerrar el archivo. Consulte ExportCallback para obtener más información sobre cómo declarar la función de devolución de llamada de exportación.

Para restaurar un archivo cifrado, llame a OpenEncryptedFileRaw y especifique CREATE_FOR_IMPORT en el parámetro ulFlags . A continuación, llame a WriteEncryptedFileRaw y pase la dirección de una función de devolución de llamada de importación definida por la aplicación. El sistema llama a esta función de devolución de llamada varias veces hasta que se haya leído y restaurado todo el contenido del archivo. Una vez completada la restauración, llame a CloseEncryptedFileRaw para liberar recursos y cerrar el archivo. Consulte ImportCallback para obtener más información sobre cómo declarar la función de devolución de llamada de importación.

Esta función está pensada para la copia de seguridad de solo archivos cifrados; consulte BackupRead para obtener una copia de seguridad de archivos sin cifrar.

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.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Professional [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)