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 DstFileName valor de parámetro. 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 códigos de error, consulte Códigos de error del sistema o el archivo de encabezado WinError.h.

Observaciones

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 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.

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	winefs.h (incluya Windows.h)
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll

Consulte también

de cifrado de archivos de

funciones de administración de archivos

SECURITY_ATTRIBUTES