MoveFileA, fonction (winbase.h)

Article
03/03/2024

Déplace un fichier existant ou un répertoire, y compris ses enfants.

Pour spécifier comment déplacer le fichier, utilisez la fonction MoveFileEx ou MoveFileWithProgress .

Pour effectuer cette opération en tant qu’opération transactionnelle, utilisez la fonction MoveFileTransacted .

Syntaxe

BOOL MoveFileA(
  [in] LPCSTR lpExistingFileName,
  [in] LPCSTR lpNewFileName
);

Paramètres

[in] lpExistingFileName

Nom actuel du fichier ou du répertoire sur l’ordinateur local.

Par défaut, le nom est limité à MAX_PATH caractères. Pour étendre cette limite à 32 767 caractères de large, ajoutez « \\ ?\ » au chemin d’accès. Pour plus d’informations, consultez Nommage de fichiers, de chemins et d’espaces de noms.

Conseil

À compter de Windows 10, version 1607, vous pouvez choisir de supprimer la limitation de MAX_PATH sans précédencer « \ ?\ ». Pour plus d’informations, consultez la section « Limitation de longueur maximale du chemin d’accès » dans Naming Files, Paths et Namespaces .

[in] lpNewFileName

Nouveau nom du fichier ou du répertoire. Le nouveau nom ne doit pas déjà exister. Un nouveau fichier peut se trouver sur un autre système de fichiers ou lecteur. Un nouveau répertoire doit se trouver sur le même lecteur.

Conseil

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction MoveFile déplace (renomme) un fichier ou un répertoire (y compris ses enfants) dans le même répertoire ou dans plusieurs répertoires. La seule mise en garde est que la fonction MoveFile échoue lors des déplacements de répertoire lorsque la destination se trouve sur un autre volume.

Si un fichier est déplacé entre des volumes, MoveFile ne déplace pas le descripteur de sécurité avec le fichier. Le fichier reçoit le descripteur de sécurité par défaut dans le répertoire de destination.

La fonction MoveFile coordonne son opération avec le service de suivi des liens, afin que les sources de liens puissent être suivies à mesure qu’elles sont déplacées.

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technologie	Prise en charge
Protocole Server Message Block (SMB) 3.0	Oui
Basculement transparent SMB 3.0 (TFO)	Voir le commentaire
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	Voir le commentaire
Système de fichiers du volume partagé de cluster (CsvFS)	Oui
Système de fichiers résilient (ReFS)	Oui

SMB 3.0 ne prend pas en charge le renommage d’autres flux de données sur les partages de fichiers avec une fonctionnalité de disponibilité continue.

Notes

L’en-tête winbase.h définit MoveFile comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

CopyFile

Fonctions de gestion des fichiers

MoveFileEx

MoveFileTransacted

MoveFileWithProgress