Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄Example►                                   ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
  Interrupt:   21h     Function:   4Fh
 
  Title:       Find Next File
 
  See also:    Find First File, Set DTA Address, DOS File Date/Time
               Formats, @GetNext
 
  Description:
 
     Assuming a previous successful call to Int 21h Function 4Eh, this
     function finds the next file in the default or specified directory
     on the default or specified drive that matches the original file
     specification.
 
     Input                             Output
 
     AH = 4Fh                          If function unsuccessful (no
     Assumes DTA points to working     matching files)
     buffer used by previous             Carry flag: set
     successful call to Int 21h          AX = Error code (12h)
     Function 4Eh or 4Fh                 See: ◄Error codes►
 
                                       If function successful
                                       (matching file found)
                                         Carry flag: clear
 
                                       Disk transfer area (DTA)
                                       filled in as follows:
 
                                       Bytes     Description
 
                                       00h-14h   Reserved (0)
                                       15h       Attribute of matched
                                                 file or directory
                                       16h-17h   Packed file time
                                       18h-19h   Packed file date
                                       1Ah-1Dh   File size
                                       1Eh-2Ah   ASCIIZ filename
                                    -♦-