Section courante

A propos

Section administrative du site

CopyFileExW

kernel32.dll Copie un fichier étendu Unicode
Windows NT 4+, Windows 2000, Windows XP, Windows 2003, Windows Vista, Windows 2008, Windows 7, Windows 2012, Windows 10

Syntaxe

BOOL CopyFileExW( LPCWSTR lpExistingFileName, LPCWSTR lpNewFileName, LPPROGRESS_ROUTINE lpProgressRoutine, LPVOID lpData, LPBOOL pbCancel, DWORD dwCopyFlags);

Paramètres

Nom Description
lpExistingFileName Ce paramètre permet d'indiquer le nom du fichier existant à copier.
lpNewFileName Ce paramètre permet d'indiquer le nouveau nom de fichier à créer.
lpProgressRoutine Ce paramètre permet d'indiquer une routine à appeler en arrière-plan pendant la processus de copie.
lpData Ce paramètre permet d'indiquer les paramètres passer à la routine en arrière-plan indiqué par le paramètre lpProgressRoutine.
pbCancel Ce paramètre permet d'indiquer, lorsqu'elle vaut TRUE, s'il est possible d'annuler la copie durant son processus ou vaut FALSE lorsqu'il faut poursuivre le processus de copie jusqu'à la fin.
dwCopyFlags Ce paramètre permet d'indiquer les différentes options de copies.
Constante Valeur Description
COPY_FILE_ALLOW_DECRYPTED_DESTINATION 0x00000008 Cette constante permet d'indiquer que la tentative de copier un fichier crypté doit réussir même si la destination de la copie ne peut pas être chiffré.
COPY_FILE_COPY_SYMLINK 0x00000800 Cette constante permet d'indiquer si le fichier source est un lien symbolique, le fichier de destination doit aussi être un lien symbolique pointant sur le même fichier que le lien symbolique source sur lequel il pointe. Cette option n'est pas supporté par Windows NT4, 2000, XP et 2003.
COPY_FILE_FAIL_IF_EXISTS 0x00000001 Cette constante permet d'indiquer que l'opération de copie échoue immédiatement si le fichier de destination existe déjà.
COPY_FILE_NO_BUFFERING 0x00001000 Cette constante permet d'indiquer que l'opération de copie est réalisé à l'aide d'entrée/sortie directe, sans passer par les ressources en cache d'entrée/sortie. Cette option est recommandé pour les gros fichiers. Cette option n'est pas supporté par Windows NT4, 2000, XP et 2003.
COPY_FILE_OPEN_SOURCE_FOR_WRITE 0x00000004 Cette constante permet d'indiquer que le fichier est copié et que le fichier d'origine est ouvert pour qu'il soit possible d'écrire dedans.
COPY_FILE_RESTARTABLE 0x00000002 Cette constante permet d'indiquer qu'il faut effectuer est copie progressive du fichier cible au cas où la copie échouerait.

Description

Cette fonction permet d'effectuer la copie d'un fichier d'un emplacement à un autre emplacement tout en effectuant un processus d'arrière plan indiquant sa progression avec des paramètres de chaine de caractères étendue (Unicode).

Voir également

Articles - Les géants de l'informatique - Microsoft

Dernière mise à jour : Dimanche, le 6 décembre 2015