Función DuplicateEncryptionInfoFile (winefs.h)

  • Artículo

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.

Valor Significado
CREATE_ALWAYS
2
 Cree siempre el archivo o directorio de destino. Cualquier valor pasado en este parámetro distinto de CREATE_NEW se procesará como CREATE_ALWAYS.
CREATE_NEW
1
 Cree el archivo o directorio de destino solo si aún no existe. Si existe y se especifica este valor, se producirá un error en esta función.

[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

Consulte también

Cifrado de archivos

Funciones de administración de archivos

SECURITY_ATTRIBUTES