Interruption 21h, Fonction 4Eh: Rechercher le première entrée du répertoire par le Handle

Interruption 21h	Fonction 4Eh	Rechercher la première entrée du répertoire par le Handle
DOS 2.0+, OS/2, Windows NT

Cette fonction permet d'effectuer la rechercher de le première entrée du répertoire en utilisant la méthode du Handle.

Registre	Valeur ou description
AH	4Eh
CX	Ce registre permet d'indiquer l'attribut de fichier:
	Bits	Description
	0	Ce bit contient la valeur 1 si l'attribut de fichier est en mode lecture seulement
	1	Ce bit contient la valeur 1 si l'attribut de fichier est en mode caché
	2	Ce bit contient la valeur 1 si l'attribut de fichier est en mode système
	5	Ce bit contient la valeur 1 si l'attribut de fichier est en mode archivage
DS:DX	Cette paire de registres permet d'indiquer l'adresse du nom de fichier sous forme de chaine de caractères ASCIZ

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 la recherche 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
			18	Cette erreur permet d'indiquer qu'il n'y a plus d'autres fichiers dans la liste

Lorsque le fichier spécifié a été trouvé, les 43 premiers octets de la zone de tampon DTA retourne ses informations:

Déplacement	Longueur	Description
00h à 14h	21 octets	Ce champ est réservé pour une utilisation interne ou futur
15h	1 octet	Ce champ est contient l'attribut du fichier
16h à 17h	2 octets (1 mot)	Ce champ est contient l'heure de la dernière modification du fichier
16h à 17h	2 octets (1 mot)	Ce champ est contient l'heure de la dernière modification du fichier
18h à 19h	2 octets (1 mot)	Ce champ est contient la date de la dernière modification du fichier
1Ah à 1Dh	4 octets (double mots)	Ce champ est contient le double mot de la taille du fichier
1Eh à 2Ah	13 octets	Ce champ est contient le nom et l'extension sous la forme d'une chaîne de caractères ASCIZ

Quand l'appel de cette fonction est faite avec des caractères génériques (? ou *), les autres fichiers peuvent être consulter grâce à l'interruption 21h, fonction 4Fh.
Cette fonction suppose que le DTA a été précédemment défini par le programme avec l'Interruption 21h, fonction 1Ah pour pointer vers un tampon de taille adéquate.
Si l'attribut est 0, seuls les fichiers ordinaires sont trouvés. Si le bit d'attribut d'étiquette de volume est défini, seules les étiquettes de volume seront renvoyées (le cas échéant). Tout autre attribut ou combinaison d'attributs (caché, système et répertoire) entraîne la correspondance de ces fichiers et de tous les fichiers normaux.

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

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

Section courante