File | Called from | Code enabled by |
---|---|---|
| Application |
|
Read a directory entry from a directory.
Arguments
p_dir
Pointer to a directory.
p_dir_entry
Pointer to variable that will receive directory entry information.
pp_result
Pointer to variable that will receive:
p_dir_entry
, if NO error occurs AND directory does not encounter EOF.- pointer to NULL if an error occurs OR directory encounters EOF.
Returned Value
1, if an error occurs.
0, otherwise.
Notes/Warnings
- Entries for “dot” (current directory) and “dot-dot” (parent directory) shall be returned, if present. No entry with an empty name shall be returned.
- If an entry is removed from or added to the directory after the directory has been opened, information may or may not be returned for that entry.