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 code DFE_OPENAID is returned and the file is not closed. This is a common occurrence when developing new interfaces. See Hendaccess for further discussion of this problem.