Interruption 21h, Fonction 56h: Renomme/Déplace un fichier par le Handle

Interruption 21h	Fonction 56h	Renomme/Déplace un fichier par le Handle
DOS 2.0+, OS/2, Windows NT

Cette fonction permet de renommer ou déplacer un fichier avec son nom.

Registre	Valeur ou description
AH	56h
DS:DX	Cette paire de registres permet d'indiquer l'adresse d'une chaîne de caractères ASCIZ contenant l'ancien nom de fichier
ES:DI	Cette paire de registres permet d'indiquer l'adresse d'une chaîne de caractères ASCIZ contenant le nouveau nom de fichier

Registre	Valeur ou description
FC	Ce registre de drapeau de retenue permet d'indiquer le résultat de l'opération :
	Valeur	Description
	0	Cette valeur permet d'indiquer que l'opération a été un succès
	1	Cette valeur permet d'indiquer une erreur, dans ce cas :
		Registre	Description
		AX	Ce registre permet d'indiquer le code d'erreur :
			Valeur	Description
			2	Cette erreur permet d'indiquer que le fichier est introuvable
			3	Cette erreur permet d'indiquer que le chemin est introuvable
			5	Cette erreur permet d'indiquer que l'accès est refusé
			11	Cette erreur permet d'indiquer le format est invalide

La fonction échouera si : aucun élément du nom de chemin n'existe, un fichier avec le nouveau nom de chemin existe déjà, la spécification de chemin actuelle contient un unité de disque différent de celui du nouveau nom de chemin ou le fichier est déplacé vers le répertoire racine et le répertoire racine est plein.
A partir de la version 3.0 du système d'exploitation DOS, le programme s'exécute sur un réseau et l'utilisateur n'a pas les droits d'accès suffisants au fichier existant ou au nouveau répertoire.
Les caractères génériques «*» et «?» ne sont pas autorisés dans les spécifications de chemin d'accès actuelles ou nouvelles.

Aide-mémoire des interruptions du MS-DOS, Edition Marabout, Philippe Mercier, 1990, ISBN: 2-501-01297-6, page 267 à 269.

Dernière mise à jour : Jeudi, le 3 mars 2016

Section courante