[Back to Interface] [Prev] [Next]

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.



[Back to Interface] [Prev] [Next]

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