[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Int 21 Fn 11  - DOS 1+ - Find First Matching File Using Fcb                [D]

   AH = 11h
   DS:DX -> unopened FCB (see AH=0Fh), may contain '?' wildcards

Return: AL = status
       00h successful
       [DTA] unopened FCB for first matching file
       FFh no matching filename, or bad FCB

Notes: the type of the returned FCB depends on whether the input FCB was a
     normal or an extended FCB
   the data returned in the DTA is actually the drive number (or extended
     FCB header and drive number) followed by the file's directory entry
     (see below); this format happens to be compatible with an unopened
     FCB
   for extended FCBs with search attribute 08h, the volume label (if any)
     will be returned even if the current directory is not the root dir.
   DOS 3+ also allows the '*' wildcard
   the search FCB must not be modified if AH=12h will be used to continue
     searching; DOS 3.3 has set the following parts of the FCB:
        0Ch    BYTE    ???
        0Dh    WORD    directory entry number of matching file
        0Fh    WORD    cluster number of current directory
        11h  4 BYTEs   ???
        15h    BYTE    drive number (1=A:)
   this function is used by many copy protection schemes to obtain the
     starting cluster of a file

See Also: AH=12h,AH=1Ah,AH=4Eh,INT 2F/AX=111Bh

Format of directory entry:
Offset Size    Description
 00h  8 BYTEs  blank-padded filename
 08h  3 BYTEs  blank-padded file extension
 0Bh   BYTE    attributes
 0Ch 10 BYTEs  reserved
       used by DR-DOS to store file password
 16h   WORD    time of creation or last update (see AX=5700h)
 18h   WORD    date of creation or last update (see AX=5700h)
 1Ah   WORD    starting cluster number
 1Ch   DWORD   file size

This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson