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.