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►                                   ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
     Use Int 21h Function 1Ah to set the DTA to point to a buffer of
     adequate size before calling these functions. Get the first file
     with Function 11h, then call Function 12h repeatedly (until it
     fails) to get additional matching files.
 
     The wildcard character ? is allowed in the filename in all
     versions of MS-DOS. In versions 3.0 and later, the wildcard
     character * may also be used in a filename. If ? or * is used,
     this function returns the first matching filename.
 
     An extended FCB must be used to search for files that have the
     system, hidden, read-only, directory, or volume-label attributes.
 
     If an extended FCB is used, its attribute byte determines the type
     of search that will be performed. If the attribute byte (byte 0)
     contains 00h, only ordinary files are found. If the volume-label
     attribute bit is set, only volume labels will be returned (if any
     are present). If any other attribute or combination of attributes
     is set (such as hidden, system, or read-only), those files and all
     ordinary files will be matched.
 
     Normally Int 21h Functions 4Eh and 4Fh should be used instead of
     these functions, since they allow full access to the hierarchical
     directory structure.
                                    -♦-