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►
──────────────────────────────────────────────────────────────────────────────
 
▀ The function fails if:
  - any element of the pathname does not exist.
  - the file is being created in the root directory and the root directory
    is full.
  - a file with the same name and the read-only attribute already exists
    in the specified directory.
  - [3.0+] the program is running on a network and the user running the
    program has insufficient access rights.
 
▀ If the volume label or directory bits are set in the file attribute
  passed in register CX, they are ignored by MS-DOS.
 
▀ A file is usually given a normal (00H) attribute when it is created. The
  file's attribute can subsequently be modified with Int 21H Function 43H.
 
▀ [3.0+] A volume label can be created using an attribute of 0008H, if one
  does not already exist. When files are created, bit 3 of the attribute
  parameter should always be clear (0).
 
▀ [3.0+] See also the entries for Int 21H Functions 5AH and 5BH, which may
  also be used to create files.
 
▀ [4.0+] Int 21H Function 6CH combines the services of Functions 3CH, 3DH,
  and 5BH.
                                    -♦-