Función OpenEncryptedFileRawA (winbase.h)
Abre un archivo cifrado para realizar copias de seguridad (exportar) o restaurar (importar) el archivo. 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, al tiempo que mantiene los archivos en su estado cifrado.
Sintaxis
DWORD OpenEncryptedFileRawA(
[in] LPCSTR lpFileName,
[in] ULONG ulFlags,
[out] PVOID *pvContext
);
Parámetros
[in] lpFileName
Nombre del archivo que se va a abrir. La cadena debe constar de caracteres del juego de caracteres de Windows.
[in] ulFlags
Operación que se va a realizar. Este parámetro puede ser uno de los siguientes valores.
[out] pvContext
Dirección de un bloque de contexto que se debe presentar en llamadas posteriores a ReadEncryptedFileRaw, WriteEncryptedFileRawo CloseEncryptedFileRaw. No lo modifique.
Valor devuelto
Si la función se ejecuta correctamente, devuelve 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 genérica del error.
Observaciones
El autor de la llamada debe tener acceso de lectura o escritura al archivo o debe tener privilegios de copia de seguridad SeBackupPrivilege en el equipo en el que residen los archivos para que la llamada se realice correctamente.
Para realizar una copia de seguridad de un archivo cifrado, llame OpenEncryptedFileRaw para abrir el archivo y, a continuación, llame a ReadEncryptedFileRaw. Cuando se complete la copia de seguridad, llame a CloseEncryptedFileRaw.
Para restaurar un archivo cifrado, llame a
openEncryptedFileRaw produce un error si lpFileName supera MAX_PATH caracteres al abrir un archivo cifrado en un equipo remoto.
Si el autor de la llamada no tiene acceso a la clave del archivo, el autor de la llamada necesita SeBackupPrivilege para exportar archivos cifrados o SeRestorePrivilege para importar archivos cifrados.
Las funciones BackupRead y BackupWrite controlan la copia de seguridad y restauración 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 | Soportado |
|---|---|
| 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 (ReFS) | No |
SMB 3.0 no admite EFS en recursos compartidos con capacidad de disponibilidad continua.
Nota
El encabezado winbase.h define OpenEncryptedFileRaw como 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
winbase.h (incluya Windows.h) |
| biblioteca de |
Advapi32.lib |
| DLL de |
Advapi32.dll |
| conjunto de API de |
ext-ms-win-advapi32-encryptedfile-l1-1-0 (introducido en Windows 8) |
Consulte también
de cifrado de archivos de