CopyFileExA |
kernel32.dll | Copie un fichier étendu |
|---|---|---|
| Windows NT 4+, Windows 2000, Windows XP, Windows 2003, Windows Vista, Windows 2008, Windows 7, Windows 2012, Windows 10 | ||
Syntaxe
| BOOL CopyFileExA( LPCSTR lpExistingFileName, LPCSTR 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.
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Dimanche, le 6 décembre 2015