Fonction MoveFile (winbase.h)
Déplace un fichier ou un répertoire existant, 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 traitée, utilisez la fonction MoveFileTransacted .
Syntaxe
BOOL MoveFile(
[in] LPCTSTR lpExistingFileName,
[in] LPCTSTR 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 larges, 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 MAX_PATH sans précédencer « \\?\ ». Pour plus d’informations, consultez la section « Limitation maximale de la longueur du chemin d’accès » de 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.
Par défaut, le nom est limité à MAX_PATH caractères. Pour étendre cette limite à 32 767 caractères larges, 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 MAX_PATH sans précédencer « \\?\ ». Pour plus d’informations, consultez la section « Limitation maximale de la longueur du chemin d’accès » de Naming Files, Paths et Namespaces .
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.
Notes
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 en cas de déplacement de répertoire lorsque la destination se trouve sur un autre volume.
Si un fichier est déplacé d’un volume à l’autre, MoveFile ne déplace pas le descripteur de sécurité avec le fichier. Le descripteur de sécurité par défaut est attribué au fichier dans le répertoire de destination.
La fonction MoveFile coordonne son fonctionnement 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 SMB (Server Message Block) 3.0 | Oui |
| Basculement transparent (TFO) SMB 3.0 | Voir le commentaire |
| SMB 3.0 avec partages de fichiers avec montée en puissance sortante (SO) | Voir le commentaire |
| Cluster Shared Volume File System (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.
Configuration requise
| 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 |