Tandy 1000 Programmer's Reference Manual page 133

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