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 ]