MoveFileW, fonction (winbase.h)
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
Pour effectuer cette opération en tant qu’opération transactionnelle, utilisez la fonction MoveFileTransacted.
Syntaxe
BOOL MoveFileW(
[in] LPCWSTR lpExistingFileName,
[in] LPCWSTR 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 des fichiers, des chemins d’accès et des espaces de noms.
Pourboire
À compter de Windows 10, version 1607, vous pouvez choisir de supprimer la limitation MAX_PATH sans précéder « \\ ?\ ». Pour plus d’informations, consultez la section « Limite maximale de longueur de chemin » de noms, fichiers, chemin s et espaces de noms.
[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 des fichiers, des chemins d’accès et des espaces de noms.
Pourboire
À compter de Windows 10, version 1607, vous pouvez choisir de supprimer la limitation MAX_PATH sans précéder « \\ ?\ ». Pour plus d’informations, consultez la section « Limite maximale de longueur de chemin » de noms, fichiers, chemin s et espaces de noms.
Valeur de retour
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’erreur étendues, appelez GetLastError.
Remarques
La fonction MoveFile déplacera (renommez) un fichier ou un répertoire (y compris ses enfants) dans le même répertoire ou dans les répertoires. La seule mise en garde est que la fonction MoveFile échoue sur le répertoire se déplace lorsque la destination se trouve sur un autre volume.
Si un fichier est déplacé entre les 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 | Supporté |
|---|---|
| Protocole SMB (Server Message Block) 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 |
| 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 de flux de données alternatifs sur les partages de fichiers avec une fonctionnalité de disponibilité continue.
Note
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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winbase.h (inclure Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |