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.

   ◄Summary►  ◄Notes►  ◄Example►  ◄Back►
──────────────────────────────────────────────────────────────────────────────
 
  Description:  Find First File
 
  Given a file specification in the form of an ASCIIZ string, searches the
  default or specified directory on the default or specified drive for the
  first matching file.
 
  Input                                     Output
  ══════════════════════════════            ═══════════════════════════════
  AH=4EH                                    If function successful (match-
  CX=attribute to use in search              ing file found)
   (bits can be combined)                   Carry flag=clear
  Bit(s)   Significance (if set)            and current disk transfer area
  0        read-only                         filled in as follows:
  1        hidden                           Byte(s)   Description
  2        system                           00H-14H   reserved (0)
  3        volume label                     15H       attribute of matched
  4        directory                                   file or directory
  5        archive                          16H-17H   file time
  6-15     reserved (0)                               bits 00H-04H=2-sec-
  DS:DX=segment:offset of ASCIIZ                       ond increments
   pathname                                            (0-29)
                                                      bits 05H-0AH=minutes
                                                       (0-59)
                                                      bits 0BH-0FH=hours
                                                       (0-23)
                                            18H-19H   file date
                                                      bits 00H-04H=day
                                                       (1-31)
                                                      bits 05H-08H=month
                                                       (1-12)
                                                      bits 09H-0FH=year
                                                       (relative to 1980)
                                            1AH-1DH   file size
                                            1EH-2AH   ASCIIZ filename and
                                                       extension
                                            If function unsuccessful (no
                                             matching files)
                                            Carry flag=set
                                            AX=error code
                                    -♦-