[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Int 21 Fn 29  - DOS 1+ - Parse Filename Into Fcb                           [D]

   AH = 29h
   AL = parsing options (see below)
   DS:SI -> filename string (both '*' and '?' wildcards OK)
   ES:DI -> buffer for unopened FCB

Return: AL = result code
       00h successful parse, no wildcards encountered
       01h successful parse, wildcards present
       FFh failed (invalid drive specifier)
   DS:SI -> first unparsed character
   ES:DI buffer filled with unopened FCB (see AH=0Fh)

Notes: asterisks expanded to question marks in the FCB
   all processing stops when a filename terminator is encountered
   cannot be used with filespecs which include a path (DOS 2+)
   Novell NetWare monitors the result code since an 'invalid drive' may
     signal an attempt to reconnect a network drive; if there are no
     connections to the specified drive, NetWare attempts to build a
     connection and map the drive to the SYS:LOGIN directory

See Also: AH=0Fh,AH=16h,AH=26h

Bitfields for parsing options:
 bit 0 skip leading separators
 bit 1 use existing drive number in FCB if no drive is specified, instead of
       setting field to zero
 bit 2 use existing filename in FCB if no base name is specified, instead of
       filling field with blanks
 bit 3 use existing extension in FCB if no extension is specified, instead of
       filling field with blanks
 bits 4-7 reserved (0)

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