Chapter
1
I
System
Calls
FindFir
s
t
Find Matching File
Function
Call
4EH
Takes
a
pathname, with wildcard characters in the filename por-
tion and
a
set of attributes, and attempts
to
find
a
file that
matches the pathname and has
a
subset
of
the required attri-
butes. If one is found,
a
data block
at
the current Disk Transfer
Address is written. The block contains information in the follow-
ing form:
21 bytes
-
1
byte
-
Attribute found
2 bytes
-
Time
of
file
2 bytes
-
Date of file
2
bytes
-
Least
significant
word
of
file
size
2 bytes
-
Most significant word of file size
13 bytes
-
To obtain the subsequent matches of the pathname, see
the description of the FindNext function call (4FH).
Entry Conditions:
AH
=
4EH
DS:DX
=
pointer to
ASCII2
pathname
CS
=
search attributes
Exit Conditions:
Carry set:
AX
=
error code
Carry not set:
No
error.
Error Returns:
AX
=
2
Reserved for MS-DOS use on subsequent
FindNext function calls (4FH)
Packed filename and extension
File not found. The path specified in DS:DX was an
invalid path.
No
more files. There were no files matching this
specification.
AX
=
18
131