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