s32 mfsRomGetDirListFirst(MfsDirID upDirID, MfsDirList* dirList, u16 attr)
s32 mfsRamGetDirListFirst(MfsDirID upDirID, MfsDirList* dirList, u16 attr)

Arguments

upDirID   Directory ID of directory

dirList   MfsDirList structure buffer

attr   Attribute

Return value

Directory ID (a negative value is an error)

Function

Obtains contents of directory

Description

This function searches the contents of the directory specified by upDirID and returns the directory ID of a directory or file having an attribute that matches the attribute specified by attr. The following values can be specified for attr.

MFS_FILE_ATTR_FORBID_W	0x2000	Write protected
MFS_FILE_ATTR_FORBID_R	0x1000	Read protected
MFS_FILE_ATTR_HIDDEN	0x0800	Hidden file
MFS_FILE_ATTR_ENCODE	0x0400	Encoded file
MFS_FILE_ATTR_COPYLIMIT	0x0200	Copy limited

When the return value is MFS_ERR_SEARCHEND, no directory contents were found.

When the return value is not an error, the next contents can be obtained by using the mfsR*mGetDirListNext function.

Main errors

MFS_ERR_SEARCHEND

Content not in directory