|
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. |