Close Directory (QHFCLODR) API
Required Parameter Group:
| 1 | Open directory handle | Input | Char(16) |
| 2 | Error code | I/O | Char(*) |
Default Public Authority: *USE
Threadsafe: No
The Close Directory (QHFCLODR) API closes a specified directory that was opened using the Open Directory (QHFOPNDR) API. Once a directory is closed, the open directory handle that refers to it is no longer valid. If a process ends without closing directories, they are closed automatically. However, it is best if the application closes directories that it no longer needs so that other applications have free access to them.
Authorities and Locks
None.
Required Parameter Group
- Open directory handle
- INPUT; CHAR(16)
The directory handle returned by the QHFOPNDR API when the directory was opened.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
Error Messages
| Message ID | Error Message Text |
|---|---|
| CPF1F05 E | Directory handle not valid. |
| CPF1F06 E | Directory in use. |
| CPF1F08 E | Damaged directory. |
| CPF1F41 E | Severe error occurred while addressing parameter list. |
| CPF1F52 E | Error code not valid. |
| CPF1F62 E | Requested function failed. |
| 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. |
| CPF1F82 E | Function not supported. |
| CPF1F87 E | Missing or damaged exit program &2. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
API introduced: V2R1
[ Back to top | Hierarchical File System APIs | APIs by category ]