nextfile

Retrieves information about the next file

struct DIRENTRY *nextfile (
        struct DIRENTRY *dir
)

Arguments

dir Pointer to DIRENTRY structure that stores information relating to the referenced file

Return Value

dir is returned if the function is successful.
0 is returned in all other cases.

Explanation

nextfile() continues the lookup function started by firstfile(). Information on matching files is placed in the DIRENTRY structure pointed to by dir.

Notes

If the shell cover of the CD-ROM drive is opened after the execution of firstfile(), nextfile() will fail and report that the file was not found.

See Also

DIRENTRY, firstfile()