Función ReadEncryptedFileRaw (winbase.h)
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) |