Función DuplicateEncryptionInfoFile (winefs.h)
Copia los metadatos de EFS de un archivo o directorio a otro.
Sintaxis
DWORD DuplicateEncryptionInfoFile(
[in] LPCWSTR SrcFileName,
[in] LPCWSTR DstFileName,
[in] DWORD dwCreationDistribution,
[in] DWORD dwAttributes,
[in, optional] const LPSECURITY_ATTRIBUTES lpSecurityAttributes
);
Parámetros
[in] SrcFileName
Nombre del archivo o directorio desde el que se van a copiar los metadatos de EFS. Este archivo de origen o directorio debe cifrarse.
[in] DstFileName
Nombre del archivo o directorio al que se van a copiar los metadatos de EFS.
Este archivo o directorio de destino no tiene que cifrarse antes de la llamada a esta función; sin embargo, si esta función se completa correctamente, se cifrará.
Si el valor de SrcFileName especifica un archivo, el valor de este parámetro también debe especificar un archivo y, del mismo modo, para los directorios. Si no existe un archivo o directorio con el nombre especificado por este parámetro, se creará un archivo o directorio (dependiendo de si SrcFileName especifica un archivo o directorio).
[in] dwCreationDistribution
Describe cómo se va a abrir el archivo o directorio de destino identificado por el valor del parámetro DstFileName . A continuación se muestran los valores válidos de este parámetro.
[in] dwAttributes
Atributos de archivo del archivo o directorio de destino. Esta función no procesa actualmente el atributo FILE_READ_ONLY .
[in, optional] lpSecurityAttributes
Puntero a una estructura de SECURITY_ATTRIBUTES que especifica los atributos de seguridad del archivo o directorio de destino, si aún no existe. Si especifica NULL, el archivo o directorio obtiene un descriptor de seguridad predeterminado. Las ACL del descriptor de seguridad predeterminado para un archivo o directorio se heredan de su directorio primario.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista completa de los códigos de error, consulta Códigos de error del sistema o el archivo de encabezado WinError.h.
Comentarios
EFS requiere acceso exclusivo al archivo o directorio de destino para la llamada a esta función. Si no se proporciona este acceso, se producirá un error en esta función.
El autor de la llamada debe tener la clave EFS para el archivo o directorio de origen y, al menos, la ACL de READ_ATTRIBUTE para el archivo o directorio de origen.
El archivo o directorios de origen y destino especificados deben residir en el mismo equipo; de lo contrario, se devolverá un error.
En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.
| 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
| 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 | winefs.h (incluye Windows.h) |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |