VFFileSearchNext(W)

C Specification


#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 information obtained and specified in dta is needed when issuing VFFileSearchNext, do not destroy the buffer when re-using VFFileSearchNext.
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.fc


CONFIDENTIAL