formZ SDK | 5.0 API Reference | System | Runtime Library (FZRT) | File

# fzrt_file_find_next_file

Description

Gets the next file in a folder. The next file is file that follows the file, in folder order, from the previous call to fzrt_file_find_next_file with the same iterator. If there has not been a previous call, it returns the first file in the folder. If the file returned is the last file in the folder, the last parameter is set to true.

Plugin Prototype

fzrt_error_td fzrt_file_find_next_file(

fzrt_file_iter_ptr | iterator,
char * | file_name,
fzrt_boolean * | last )

Parameters

iterator [Input]

iterator object returned by fzrt_file_find_file_init

file_name [Result]

Name of file as C string. User must allocate.

last [Result]

contains true if this is there are no more files after this. The file_name is valid if last is true and the return value is FZRT_NOERR.

Returns

FZRT_NOERR on success, Otherwise, an error ID.

Availability

5.0.0.0

See Also

fzrt_file_find_file_init

Function Set

fz_fzrt_file_fset

Defined in

fzrt_api.h