| 1 | Path name | Input | Char(*) |
| 2 | Length of path name | Input | Binary(4) |
| 3 | Attribute information table | Input | Char(*) |
| 4 | Length of attribute information table | Input | Binary(4) |
| 5 | Error code | I/O | Char(*) |
The Create Directory (QHFCRTDR) API creates a new directory and its directory entry. Except for the directory being created, all directories in the path must exist.
None.
The path name for the new directory. The last element of the path name specifies the directory being created. For example, specifying /QDLS/A/B creates new directory B and adds a directory entry for B to directory A in file system QDLS.
The length of the path name, in bytes.
The table specifying the attributes for the new directory. The file system determines which standard and extended attributes you can specify. For detailed descriptions of the standard attributes and the format of the table, see HFS Directory Entry Attributes.
If no attributes are specified, the file system's defaults are used for required information.
The length of the attribute information table, in bytes. Valid values are:
| length | Use the attributes specified in the table. |
| 0 | Use the system defaults for standard attributes instead of using the attributes in the table. |
The structure in which to return error information. For the format of the structure, see Error Code Parameter.
| Message ID | Error Message Text |
|---|---|
| CPF1F01 E | Directory name not valid. |
| CPF1F02 E | Directory not found. |
| CPF1F04 E | Directory name already exists. |
| CPF1F06 E | Directory in use. |
| CPF1F07 E | Authority not sufficient to access directory. |
| CPF1F08 E | Damaged directory. |
| CPF1F09 E | Use of reserved directory name not allowed. |
| CPF1F41 E | Severe error occurred while addressing parameter list. |
| CPF1F42 E | Attribute information table not valid. |
| CPF1F43 E | Attribute name not valid. |
| CPF1F44 E | Attribute value is not valid. |
| CPF1F46 E | Use of reserved attribute name not allowed. |
| CPF1F48 E | Path name not valid. |
| CPF1F52 E | Error code not valid. |
| CPF1F61 E | No free space available on media. |
| CPF1F62 E | Requested function failed. |
| CPF1F63 E | Media is write protected. |
| CPF1F66 E | Storage needed exceeds maximum limit for user profile &1. |
| CPF1F71 E | Exception specific to file system occurred. |
| CPF1F72 E | Internal file system error occurred. |
| CPF1F73 E | Not authorized to use command. |
| CPF1F74 E | Not authorized to object. |
| CPF1F75 E | Error occurred during start-job-session function. |
| CPF1F81 E | API specific error occurred. |
| CPF1F82 E | Function not supported. |
| CPF1F83 E | File system name &1 not found. |
| CPF1F85 E | Not authorized to file system &1. |
| CPF1F87 E | Missing or damaged exit program &2. |
| CPF1F97 E | File system &1 in use. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
| Top | Hierarchical File System APIs | APIs by category |