Method
GioFileEnumeratornext_files_async
Declaration
void
g_file_enumerator_next_files_async (
GFileEnumerator* enumerator,
int num_files,
int io_priority,
GCancellable* cancellable,
GAsyncReadyCallback callback,
gpointer user_data
)
Description
Request information for a number of files from the enumerator asynchronously.
When all i/o for the operation is finished the callback
will be called with
the requested information.
See the documentation of GFileEnumerator
for information about the
order of returned files.
The callback can be called with less than num_files
files in case of error
or at the end of the enumerator. In case of a partial error the callback will
be called with any succeeding items and no error, and on the next request the
error will be reported. If a request is cancelled the callback will be called
with G_IO_ERROR_CANCELLED
.
During an async request no other sync and async calls are allowed, and will
result in G_IO_ERROR_PENDING
errors.
Any outstanding i/o request with higher priority (lower numerical value) will
be executed before an outstanding request with lower priority. Default
priority is G_PRIORITY_DEFAULT
.
Parameters
num_files
-
Type:
int
The number of file info objects to request.
io_priority
-
Type:
int
The [I/O priority][io-priority] of the request.
cancellable
-
Type:
GCancellable
Optional
GCancellable
object,NULL
to ignore.The argument can be NULL
.The data is owned by the caller of the method. callback
-
Type:
GAsyncReadyCallback
A
GAsyncReadyCallback
to call when the request is satisfied.The argument can be NULL
. user_data
-
Type:
gpointer
The data to pass to callback function.
The argument can be NULL
.The data is owned by the caller of the method.