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.

                                             ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
  Include:   DOS.INC
 
  Syntax:    @GetFirst path [,[attribute] [,segment]]
             @GetNext
 
  Summary:   Converts file specifications (optionally including wild
             cards) into filenames. These macros are usually used with
             @GetDTA and @SetDTA. Use @SetDTA to set the address where
             the data for each file will be stored.
 
  Arguments: <path>          Offset address of fully specified ASCIIZ
                             file name; can have wild cards. Must be an
                             offset address.
 
             <attribute>     File attribute to search for; 0 for normal
                             if none given.
 
             <segment>       Segment of path; uses DS if none given.
 
  Returns:   If carry: set, error code in AX
 
  Modifies:  For @GetFirst, AX, CX, DX; DS if segment changed;
             for @GetNext, AX only
 
  See also:  Int 21h Functions 4Eh and 4Fh, @SetDTA, @GetDTA, SHOW.ASM
                                    -♦-