DuplicateEncryptionInfoFile, fonction (winefs.h)

Article
11/20/2024

Copie les métadonnées EFS d’un fichier ou d’un répertoire vers 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, ainsi que 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 le fichier de destination ou le répertoire identifié par la valeur du paramètre DstFileName doit être ouverte. 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 sera 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à. S’il 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 de retour

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 au 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 fichier ou les répertoires source et de destination spécifiés doivent résider sur le même ordinateur ; sinon, une erreur est retournée.

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

Technologie	Supporté
Protocole SMB (Server Message Block) 3.0	Oui
Basculement transparent SMB 3.0 (TFO)	Non
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	Non
Cluster Shared Volume File System (CsvFS)	Non
Système de fichiers résilient (ReFS)	Non

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winefs.h (include Windows.h)
bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

de chiffrement de fichiers

fonctions de gestion de fichiers

SECURITY_ATTRIBUTES

Partager via