FindFirstpgm Function

Microchip MDD File System Interface

previous page next page
MDDFS Interface Library Help
Contents | Index | Home
Previous | Up | Next
FindFirstpgm Function
C
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.

APIs > File Manipulation Layer (FSIO) > Public Members > FindFirstpgm Function
Microchip MDD File System Interface 1.2.0 - [Aug 18, 2008]
Copyright © 2008 Microchip Technology, Inc.  All rights reserved.
Contents | Index | Home
previous page start next page