Remplace un fichier par un autre fichier, et crée une copie de sauvegarde du fichier original
#include <WinAPIFiles.au3>
_WinAPI_ReplaceFile ( $sReplacedFile, $sReplacementFile [, $sBackupFile = '' [, $iFlags = 0]] )
| $sReplacedFile | Le nom du fichier à remplacer. |
| $sReplacementFile | Le nom du fichier qui remplacera le fichier $sReplacedFile. |
| $sBackupFile | [optionnel] Le nom du fichier qui servira à la copie de sauvegarde du fichier $sReplacedFile. Si ce paramètre est la chaîne vide, aucun fichier de sauvegarde n'est créé. |
| $iFlags | [optionnel] Les options de remplacement. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes: $REPLACEFILE_WRITE_THROUGH $REPLACEFILE_IGNORE_MERGE_ERRORS $REPLACEFILE_IGNORE_ACL_ERRORS |
| Succès: | Retourne True. |
| Échec: | Retourne False (Voir Remarques). |
Si cette fonction échoue, appelez la fonction _WinAPI_GetLastError() pour obtenir des informations supplémentaires sur l'erreur. Ci dessous, des codes d'erreur possibles pour cette fonction:
ERROR_UNABLE_TO_MOVE_REPLACEMENT (1176)
Le fichier de remplacement ne peut pas être renommé. Si $sBackupFile a été spécifié, les fichiers remplacé et de remplacement conservent leur nom de fichier d'origine. Sinon, le fichier remplacé n'existe plus et le fichier de remplacement existe sous son nom d'origine.
ERROR_UNABLE_TO_MOVE_REPLACEMENT_2 (1177)
Le fichier de remplacement ne peut pas être déplacé. Le fichier de remplacement existe toujours sous son nom d'origine; cependant, il a hérité des flux et des attributs du fichier qu'il remplace. Le fichier à remplacer existe encore avec le nom spécifié par $sReplacedFile.
ERROR_UNABLE_TO_REMOVE_REPLACED (1175)
Le fichier remplacé n'a pas pu être supprimé. Les fichiers remplacé et de remplacement conservent leurs noms de fichier d'origine.
Si une autre erreur est retournée, comme ERROR_INVALID_PARAMETER (87), les fichiers remplacé et de remplacement conserveront leur nom de fichier d'origine. Dans ce scénario, un fichier de sauvegarde n'existe pas et il n'est pas garanti que le fichier de remplacement aura hérité de tous les attributs et des flux du fichier remplacé.
Consultez ReplaceFile dans la librairie MSDN.