Function 4Eh Find First Matching File (FIND FIRST)
entry AH 4Eh
CX search attributes
DS:DX pointer to ASCIIZ filename (with attributes)
return CF set AX error code (2, 12h)
clear data block written at current DTA
format of block is: (info from BIX)
documented by Micro- |00h 1 byte attribute byte of search
soft as "reserved for |01h 1 byte drive letter for search
DOS' use on subsquent |02h 11 bytes the search name used
Find Next calls" |0Ch 2 bytes word value of last entry
function 4Fh |0Fh 4 bytes dword pointer to this DTA
|13h 2 bytes word directory start
| PC-DOS 3.10 (from INTERRUP.ARC)
|00h 1 byte drive letter
|01h-0Bh bytes search template
|0Ch 1 byte search attributes
| DOS 2.x (and DOS 3.x except 3.1?) (from INTERRUP.ARC)
|00h 1 byte search attributes
|01h 1 byte drive letter
|02h-0Ch bytes search template
|0Dh-0Eh 2 bytes entry count within directory
|0Fh-12h bytes reserved
|13h-14h 2 bytes cluster number of parent directory
15h 1 byte file attribute
16h 2 bytes file time
18h 2 bytes file date
1Ah 2 bytes low word of file size
1Ch 2 bytes high word of file size
1Eh 13 bytes name and extension of file found, plus
1 byte of 0s. All blanks are removed
from the name and extension, and if an
extension is present it is preceded by a
period.
note 1) Will not find volume label
2) This function does not support network operations
3) Wildcards are allowed in the filespec
4) If the attribute is zero, only ordinary files are found. If the volume
label bit is set, only volume labels will be found. Any other attribute
will return that attribute and all normal files together.
5) To look for everything except the volume label, set the hidden, system,
and subdirectory bits all to 1