VFFileSearchNext(W)

Syntax


#include <revolution/vf.h>

typedef s32	VFErr;

VFErr VFFileSearchNext( VFDta* dta );
VFErr VFFileSearchNextW( VFWDta* dta );

Arguments

dta The address storing the file search information.

Return Values

Returns 0 when successful.
Otherwise, returns VFErr other than 0.

Description

This function performs the next file search in conjunction with the specified file search information.

The file search information obtained with VFFileSearchFirst is specified for dta.
As a result, VFFileSearchFirst must be issued before VFFileSearchNext.
When a file matching the search conditions is found, that results is stored in dta.
The longName is stored as a search result when the file name exceeds the 8.3 letters convention or when the file name fits the format but is all lowercase. In this case, the short file name is stored in fileName.

Because the obtained dta information is necessary when VFFileSearchNext is issued, do not destroy this buffer if VFFileSearchNext is going to be reused.
The VFDta structure is a region used for VF internal processes. Operations cannot be guaranteed if VFDta has been edited.

See Also

VFFileSearchFirst, VFDta

Revision History

2006/05/31
2007/05/08 Revised Description.


CONFIDENTIAL