[Top]
[Prev]
[Next]
[Bottom]
Hfidinquire
intn Hfidinquire(int32
file_id
, char **
filename
, intn *
access
, intn *
attach
)
file_id
IN:
File identifier returned by
Hopen
filename
OUT:
Complete path and filename for the file
access
OUT:
Access mode file is opened with
attach
OUT:
Number of access identifiers attached to the file
Purpose
Returns file information through a reference of its file identifier.
Return value
Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.
Description
Gets the complete path name, access mode, and number of access identifiers associated with a file. The
filename
parameter is a pointer to a character pointer which will be modified when the function returns. Upon completion,
filename
is set to point to the file name in internal storage. All output parameters must be non-null pointers.
[Top]
[Prev]
[Next]
[Bottom]
hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.