[Back to Interface] [Next]

Hclose/hclose

intn Hclose(int32 file_id)

file_id IN:

File identifier returned by Hopen

Purpose

Closes the access path to the file.

Return value

Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.

Description

The file identifier file_id is validated before the file is closed. If the identifier is valid, the function closes the access path to the file.

If there are still access identifiers attached to the file, the error DFE_OPENAID is placed on the error stack, FAIL (or -1) is returned, and the file remains open. This is a common error when developing new interfaces. Refer to the Reference Manual page on Hendaccess for a discussion of this problem.

FORTRAN

integer function hclose(file_id)

integer file_id



[Back to Interface] [Next]

hdfhelp@ncsa.uiuc.edu
HDF Reference Manual - 07/29/98, NCSA HDF Development Group.