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.

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

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

Configuration requise

Voir aussi

Chiffrement de fichiers

Fonctions de gestion des fichiers

SECURITY_ATTRIBUTES