UDF > WinAPIEx > Files & Devices > Files >


_WinAPI_ReplaceFile

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]] )

Param�tres

$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

Valeur de retour

Succ�s: Retourne True.
�chec: Retourne False (Voir Remarques).

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�.

Voir aussi

Consultez ReplaceFile dans la librairie MSDN.