CopyFile2, fonction (winbase.h)

Copie un fichier existant dans un nouveau fichier, en informant l’application de sa progression au moyen d’une fonction de rappel.

Syntaxe

HRESULT CopyFile2(
  [in]           PCWSTR                        pwszExistingFileName,
  [in]           PCWSTR                        pwszNewFileName,
  [in, optional] COPYFILE2_EXTENDED_PARAMETERS *pExtendedParameters
);

Paramètres

[in] pwszExistingFileName

Nom d’un fichier existant.

Pour étendre cette limite à 32 767 caractères de large, ajoutez « \? » au chemin. Pour plus d’informations, consultez Nommage de fichiers, de chemins et d’espaces de noms.

[in] pwszNewFileName

Nom du nouveau fichier.

Pour étendre cette limite à 32 767 caractères de large, ajoutez « \? » au chemin. Pour plus d’informations, consultez Nommage de fichiers, de chemins et d’espaces de noms.

[in, optional] pExtendedParameters

Adresse facultative d’une structure de COPYFILE2_EXTENDED_PARAMETERS .

Valeur retournée

Si la fonction réussit, la valeur de retour retourne TRUE lorsqu’elle est passée à la macro SUCCEEDED .

Remarques

Cette fonction conserve les attributs étendus, le stockage structuré OLE, les flux de données alternatifs du système de fichiers NTFS et les attributs de fichier. Les attributs de sécurité du fichier existant ne sont pas copiés dans le nouveau fichier. Pour copier des attributs de sécurité, utilisez la fonction SHFileOperation .

Cette fonction échoue avec HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) si le fichier de destination existe déjà et que l’attribut FILE_ATTRIBUTE_HIDDEN ou FILE_ATTRIBUTE_READONLY défini.

Pour compiler une application qui utilise cette fonction, définissez la macro _WIN32_WINNT comme _WIN32_WINNT_WIN8 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

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

À compter de Windows 10, version 1903 et Windows Server 2022, une nouvelle valeur, COPY_FILE_REQUEST_COMPRESSED_TRAFFIC, est prise en charge pour le champ dwCopyFlags de la structure COPYFILE2_EXTENDED_PARAMETERS passée dans l’argument pExtendedParameters à cette fonction. Cette nouvelle valeur demande que le canal de transfert sous-jacent compresse les données pendant l’opération de copie. La demande peut ne pas être prise en charge pour tous les supports, auquel cas elle est ignorée. Les attributs et paramètres de compression (complexité de calcul, utilisation de la mémoire) ne sont pas configurables via cette API et peuvent être modifiés entre différentes versions du système d’exploitation. Sur Windows 10, l’indicateur est pris en charge pour les fichiers résidant sur des partages SMB, où la version négociée du protocole SMB est SMB v3.1.1 ou version ultérieure.

Configuration requise

Voir aussi

COPYFILE2_EXTENDED_PARAMETERS

Fonctions de gestion des fichiers