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 New File     DOS 3 Only
 
  Given an ASCIIZ pathname, creates a file in the designated or default
  directory on the designated or default drive and returns a handle that
  can be used by the program for subsequent access to the file. If a file
  with the same name already exists, the function fails.
 
  Input                                          Output
  ═══════════════════════════════════            ═════════════════════════
  AH=5BH                                         AH=5BH
  CX=attribute (bits can be combined)            If function sucessful
     Bit(s)   Significance (if set)              Carry flag=clear
     0        read-only                          AX=handle
     1        hidden                             If function unsucessful
     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
                                    -♦-