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

# fzrt_file_find_next_floc

Description

Gets the next file or folder in a folder. The next floc is the file or folder that follows the floc from the previous call to this function with the same iterator. If there has not been a previous call, it returns the first file in the folder. If the floc returned is the last in the folder, the last parameter is set to true.
The iterator must be created by fzrt_file_find_file_init or before calling this function. If the iterator is created with fzrt_file_find_file_init, this function will return the indexed file, and if the iterator is created with , this function will return the indexed sub folder.

Plugin Prototype

fzrt_error_td fzrt_file_find_next_floc(

fzrt_file_iter_ptr | iterator,
fzrt_floc_ptr | floc,
fzrt_boolean * | last )

Parameters

iterator [Input]

iterator object returned by fzrt_file_find_file_init

floc [Result]

file locator. Must be created prior to the call.

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