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:  Create File
 
  Given an ASCIIZ pathname, creates a new file in the designated or default
  directory on the designated or default disk drive. If the specified file
  already exists, it is truncated to zero length. In either case, the file
  is opened and a handle is returned that can be used by the program for
  subsequent access to the file.
 
  Input                                               Output
  ════════════════════════════════════════            ════════════════════
  AH=3CH                                              If function success-
  CX=file attribute (bits can be combined)             ful
     Bit(s)  Significance (if set)                    Carry flag=clear
     0       read-only                                AX=handle
     1       hidden                                   If function failed
     2       system                                   Carry flag=set
     3       volume label                             AX=error code
     4       reserved (0)
     5       archive
     6-15    reserved (0)
  DS:DX=segment:offset of ASCIIZ pathname
                                    -♦-