FindFirstpgm Function

MDDFS Interface Library Help

int FindFirstpgm(
    const rom char * fileName, 
    unsigned int attr, 
    SearchRec * rec
);

Description

The FindFirstpgm function will copy a PIC18 ROM fileName argument into a RAM array, and then pass that array to the FindFirst function.

Preconditions

None

Parameters

Parameters	Description
fileName	The name of the file to be found (ROM)
attr	The attributes of the file to be found
rec	Pointer to a search record to store the file info in

Return Values

Return Values	Description
0	File was found
-1	No file matching the given parameters was found

Side Effects

Search criteria from previous FindFirst call on passed SearchRec object will be lost. The FSerrno variable will be changed.

Remarks

Call FindFirstpgm or FindFirst before calling FindNext. This function is for use with PIC18 when passing arguments in ROM.