Fonction DuplicateEncryptionInfoFile (winefs.h)

Copie les métadonnées EFS d’un fichier ou d’un répertoire à un autre.

Syntaxe

DWORD DuplicateEncryptionInfoFile(
  [in]           LPCWSTR                     SrcFileName,
  [in]           LPCWSTR                     DstFileName,
  [in]           DWORD                       dwCreationDistribution,
  [in]           DWORD                       dwAttributes,
  [in, optional] const LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

Paramètres

[in] SrcFileName

Nom du fichier ou du répertoire à partir duquel les métadonnées EFS doivent être copiées. Ce fichier ou répertoire source doit être chiffré.

[in] DstFileName

Nom du fichier ou du répertoire dans lequel les métadonnées EFS doivent être copiées.

Ce fichier ou répertoire de destination n’a pas besoin d’être chiffré avant l’appel à cette fonction ; Toutefois, si cette fonction se termine correctement, elle sera chiffrée.

Si la valeur de SrcFileName spécifie un fichier, la valeur de ce paramètre doit également spécifier un fichier, et de même pour les répertoires. Si un fichier ou un répertoire portant le nom spécifié par ce paramètre n’existe pas, un fichier ou un répertoire (selon que SrcFileName spécifie un fichier ou un répertoire) est créé.

[in] dwCreationDistribution

Décrit comment ouvrir le fichier de destination ou le répertoire identifié par la valeur du paramètre DstFileName . Voici les valeurs valides de ce paramètre.

Valeur	Signification
CREATE_ALWAYS 2	Créez toujours le fichier ou le répertoire de destination. Toute valeur passée dans ce paramètre autre que CREATE_NEW est traitée comme CREATE_ALWAYS.
CREATE_NEW 1	Créez le fichier ou le répertoire de destination uniquement s’il n’existe pas déjà. Si elle existe et que cette valeur est spécifiée, cette fonction échoue.

[in] dwAttributes

Attributs de fichier du fichier ou du répertoire de destination. L’attribut FILE_READ_ONLY n’est actuellement pas traité par cette fonction.

[in, optional] lpSecurityAttributes

Pointeur vers une structure SECURITY_ATTRIBUTES qui spécifie les attributs de sécurité du fichier ou du répertoire de destination, s’il n’existe pas déjà. Si vous spécifiez NULL, le fichier ou le répertoire obtient un descripteur de sécurité par défaut. Les listes de contrôle d’accès dans le descripteur de sécurité par défaut d’un fichier ou d’un répertoire sont héritées de son répertoire parent.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est un code d’erreur système. Pour obtenir la liste complète des codes d’erreur, consultez Codes d’erreur système ou le fichier d’en-tête WinError.h.

Remarques

L’accès exclusif au fichier ou répertoire de destination est requis par EFS pour l’appel à cette fonction. Si cet accès n’est pas fourni, cette fonction échoue.

L’appelant doit avoir la clé EFS pour le fichier ou le répertoire source, et au moins la liste de contrôle d’accès READ_ATTRIBUTE pour le fichier ou le répertoire source.

Le ou les répertoires source et de destination spécifiés doivent résider sur le même ordinateur ; dans le cas contraire, une erreur est retournée.

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technologie	Prise en charge
Protocole Server Message Block (SMB) 3.0	Oui
Basculement transparent SMB 3.0 (TFO)	No
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	Non
Système de fichiers du volume partagé de cluster (CsvFS)	No
Système de fichiers résilient (ReFS)	No

 

SMB 3.0 ne prend pas en charge EFS sur les partages avec une fonctionnalité de disponibilité continue.

Configuration requise

Client minimal pris en charge	Windows XP Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winefs.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

Chiffrement de fichiers

Fonctions de gestion des fichiers

SECURITY_ATTRIBUTES