72
72
<div class="refsynopsisdiv" title="Synopsis">
73
73
<a name="GFileEnumerator.synopsis"></a><h2>Synopsis</h2>
74
74
<pre class="synopsis">
75
76
#include <gio/gio.h>
77
78
<a class="link" href="GFileEnumerator.html#GFileEnumerator-struct" title="GFileEnumerator">GFileEnumerator</a>;
78
<a class="link" href="GFileInfo.html" title="GFileInfo"><span class="returnvalue">GFileInfo</span></a> * <a class="link" href="GFileEnumerator.html#g-file-enumerator-next-file" title="g_file_enumerator_next_file ()">g_file_enumerator_next_file</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator,
79
<a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
80
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
81
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFileEnumerator.html#g-file-enumerator-close" title="g_file_enumerator_close ()">g_file_enumerator_close</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator,
82
<a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
83
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
84
<span class="returnvalue">void</span> <a class="link" href="GFileEnumerator.html#g-file-enumerator-next-files-async" title="g_file_enumerator_next_files_async ()">g_file_enumerator_next_files_async</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator,
85
<span class="returnvalue">int</span> num_files,
86
<span class="returnvalue">int</span> io_priority,
87
<a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
88
<a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
89
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);
90
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="GFileEnumerator.html#g-file-enumerator-next-files-finish" title="g_file_enumerator_next_files_finish ()">g_file_enumerator_next_files_finish</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator,
91
<a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
92
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
93
<span class="returnvalue">void</span> <a class="link" href="GFileEnumerator.html#g-file-enumerator-close-async" title="g_file_enumerator_close_async ()">g_file_enumerator_close_async</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator,
94
<span class="returnvalue">int</span> io_priority,
95
<a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
96
<a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
97
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);
98
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFileEnumerator.html#g-file-enumerator-close-finish" title="g_file_enumerator_close_finish ()">g_file_enumerator_close_finish</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator,
99
<a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
100
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
101
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFileEnumerator.html#g-file-enumerator-is-closed" title="g_file_enumerator_is_closed ()">g_file_enumerator_is_closed</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator);
102
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GFileEnumerator.html#g-file-enumerator-has-pending" title="g_file_enumerator_has_pending ()">g_file_enumerator_has_pending</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator);
103
<span class="returnvalue">void</span> <a class="link" href="GFileEnumerator.html#g-file-enumerator-set-pending" title="g_file_enumerator_set_pending ()">g_file_enumerator_set_pending</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator,
104
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pending);
105
<a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> * <a class="link" href="GFileEnumerator.html#g-file-enumerator-get-container" title="g_file_enumerator_get_container ()">g_file_enumerator_get_container</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator);
79
<a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> * <a class="link" href="GFileEnumerator.html#g-file-enumerator-next-file" title="g_file_enumerator_next_file ()">g_file_enumerator_next_file</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator,
80
<a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
82
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
85
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
86
>gboolean</a> <a class="link" href="GFileEnumerator.html#g-file-enumerator-close" title="g_file_enumerator_close ()">g_file_enumerator_close</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator,
87
<a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
89
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
91
void <a class="link" href="GFileEnumerator.html#g-file-enumerator-next-files-async" title="g_file_enumerator_next_files_async ()">g_file_enumerator_next_files_async</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator,
94
<a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
95
<a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback,
97
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
98
>gpointer</a> user_data);
100
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
101
>GList</a> * <a class="link" href="GFileEnumerator.html#g-file-enumerator-next-files-finish" title="g_file_enumerator_next_files_finish ()">g_file_enumerator_next_files_finish</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator,
102
<a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result,
104
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
105
>GError</a> **error);
106
void <a class="link" href="GFileEnumerator.html#g-file-enumerator-close-async" title="g_file_enumerator_close_async ()">g_file_enumerator_close_async</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator,
108
<a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
109
<a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback,
111
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
112
>gpointer</a> user_data);
114
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
115
>gboolean</a> <a class="link" href="GFileEnumerator.html#g-file-enumerator-close-finish" title="g_file_enumerator_close_finish ()">g_file_enumerator_close_finish</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator,
116
<a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result,
118
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
119
>GError</a> **error);
121
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
122
>gboolean</a> <a class="link" href="GFileEnumerator.html#g-file-enumerator-is-closed" title="g_file_enumerator_is_closed ()">g_file_enumerator_is_closed</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator);
124
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
125
>gboolean</a> <a class="link" href="GFileEnumerator.html#g-file-enumerator-has-pending" title="g_file_enumerator_has_pending ()">g_file_enumerator_has_pending</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator);
126
void <a class="link" href="GFileEnumerator.html#g-file-enumerator-set-pending" title="g_file_enumerator_set_pending ()">g_file_enumerator_set_pending</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator,
128
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
129
>gboolean</a> pending);
130
<a class="link" href="GFile.html" title="GFile">GFile</a> * <a class="link" href="GFileEnumerator.html#g-file-enumerator-get-container" title="g_file_enumerator_get_container ()">g_file_enumerator_get_container</a> (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator);
108
133
<div class="refsect1" title="Object Hierarchy">
109
134
<a name="GFileEnumerator.object-hierarchy"></a><h2>Object Hierarchy</h2>
110
135
<pre class="synopsis">
111
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
112
137
+----GFileEnumerator
115
140
<div class="refsect1" title="Properties">
116
141
<a name="GFileEnumerator.properties"></a><h2>Properties</h2>
117
142
<pre class="synopsis">
118
"<a class="link" href="GFileEnumerator.html#GFileEnumerator--container" title='The "container" property'>container</a>" <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>* : Write / Construct Only
143
"<a class="link" href="GFileEnumerator.html#GFileEnumerator--container" title='The "container" property'>container</a>" <a class="link" href="GFile.html" title="GFile">GFile</a>* : Write / Construct Only
121
146
<div class="refsect1" title="Description">
179
216
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
180
<td> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
217
<td> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a
218
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
219
><code class="literal">NULL</code></a> to ignore.
184
223
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
185
<td> location to store the error occuring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore
224
<td> location to store the error occuring, or <a
225
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
226
><code class="literal">NULL</code></a> to ignore
189
230
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
190
<td> A <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error or end of enumerator.
191
Free the returned object with <a href="/usr/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-unref"><code class="function">g_object_unref()</code></a> when no longer needed.
231
<td> A <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a> or <a
232
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
233
><code class="literal">NULL</code></a> on error or end of enumerator.
234
Free the returned object with <code class="function">g_object_unref()</code> when no longer needed.
198
241
<div class="refsect2" title="g_file_enumerator_close ()">
199
242
<a name="g-file-enumerator-close"></a><h3>g_file_enumerator_close ()</h3>
200
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_enumerator_close (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator,
201
<a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
202
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
243
<pre class="programlisting"><a
244
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
245
>gboolean</a> g_file_enumerator_close (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator,
246
<a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
248
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
249
>GError</a> **error);</pre>
204
251
Releases all resources used by this enumerator, making the
205
enumerator return <a class="link" href="gio-GIOError.html#G-IO-ERROR-CLOSED:CAPS"><code class="literal">G_IO_ERROR_CLOSED</code></a> on all calls.
252
enumerator return <a class="link" href="gio-GIOError.html#G-IO-ERROR-CLOSED--CAPS"><code class="literal">G_IO_ERROR_CLOSED</code></a> on all calls.
208
255
This will be automatically called when the last reference
209
256
is dropped, but you might want to call this function to make
210
257
sure resources are released as early as possible.</p>
211
260
<div class="variablelist"><table border="0">
212
261
<col align="left" valign="top">
220
269
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
221
<td> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
270
<td> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a
271
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
272
><code class="literal">NULL</code></a> to ignore.
225
276
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
226
<td> location to store the error occuring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore
277
<td> location to store the error occuring, or <a
278
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
279
><code class="literal">NULL</code></a> to ignore
230
283
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
231
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> on success or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> on error.
285
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
286
><span class="type">TRUE</span></a> on success or <a
287
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
288
><span class="type">FALSE</span></a> on error.
238
295
<div class="refsect2" title="g_file_enumerator_next_files_async ()">
239
296
<a name="g-file-enumerator-next-files-async"></a><h3>g_file_enumerator_next_files_async ()</h3>
240
<pre class="programlisting"><span class="returnvalue">void</span> g_file_enumerator_next_files_async (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator,
241
<span class="returnvalue">int</span> num_files,
242
<span class="returnvalue">int</span> io_priority,
243
<a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
244
<a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
245
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
297
<pre class="programlisting">void g_file_enumerator_next_files_async (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator,
300
<a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
301
<a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback,
303
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
304
>gpointer</a> user_data);</pre>
247
306
Request information for a number of files from the enumerator asynchronously.
248
307
When all i/o for the operation is finished the <em class="parameter"><code>callback</code></em> will be called with
341
420
<div class="refsect2" title="g_file_enumerator_close_async ()">
342
421
<a name="g-file-enumerator-close-async"></a><h3>g_file_enumerator_close_async ()</h3>
343
<pre class="programlisting"><span class="returnvalue">void</span> g_file_enumerator_close_async (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator,
344
<span class="returnvalue">int</span> io_priority,
345
<a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
346
<a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
347
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
422
<pre class="programlisting">void g_file_enumerator_close_async (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator,
424
<a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
425
<a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback,
427
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
428
>gpointer</a> user_data);</pre>
349
430
Asynchronously closes the file enumerator.
352
If <em class="parameter"><code>cancellable</code></em> is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
433
If <em class="parameter"><code>cancellable</code></em> is not <a
434
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
435
><code class="literal">NULL</code></a>, then the operation can be cancelled by
353
436
triggering the cancellable object from another thread. If the operation
354
was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned in
437
was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED--CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned in
355
438
<a class="link" href="GFileEnumerator.html#g-file-enumerator-close-finish" title="g_file_enumerator_close_finish ()"><code class="function">g_file_enumerator_close_finish()</code></a>.</p>
356
441
<div class="variablelist"><table border="0">
357
442
<col align="left" valign="top">
389
476
<div class="refsect2" title="g_file_enumerator_close_finish ()">
390
477
<a name="g-file-enumerator-close-finish"></a><h3>g_file_enumerator_close_finish ()</h3>
391
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_file_enumerator_close_finish (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator"><span class="returnvalue">GFileEnumerator</span></a> *enumerator,
392
<a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
393
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
478
<pre class="programlisting"><a
479
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
480
>gboolean</a> g_file_enumerator_close_finish (<a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *enumerator,
481
<a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result,
483
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
484
>GError</a> **error);</pre>
395
486
Finishes closing a file enumerator, started from <a class="link" href="GFileEnumerator.html#g-file-enumerator-close-async" title="g_file_enumerator_close_async ()"><code class="function">g_file_enumerator_close_async()</code></a>.
398
489
If the file enumerator was already closed when <a class="link" href="GFileEnumerator.html#g-file-enumerator-close-async" title="g_file_enumerator_close_async ()"><code class="function">g_file_enumerator_close_async()</code></a>
399
was called, then this function will report <a class="link" href="gio-GIOError.html#G-IO-ERROR-CLOSED:CAPS"><code class="literal">G_IO_ERROR_CLOSED</code></a> in <em class="parameter"><code>error</code></em>, and
400
return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. If the file enumerator had pending operation when the close
401
operation was started, then this function will report <a class="link" href="gio-GIOError.html#G-IO-ERROR-PENDING:CAPS"><code class="literal">G_IO_ERROR_PENDING</code></a>, and
402
return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. If <em class="parameter"><code>cancellable</code></em> was not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation may have been
490
was called, then this function will report <a class="link" href="gio-GIOError.html#G-IO-ERROR-CLOSED--CAPS"><code class="literal">G_IO_ERROR_CLOSED</code></a> in <em class="parameter"><code>error</code></em>, and
492
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
493
><code class="literal">FALSE</code></a>. If the file enumerator had pending operation when the close
494
operation was started, then this function will report <a class="link" href="gio-GIOError.html#G-IO-ERROR-PENDING--CAPS"><code class="literal">G_IO_ERROR_PENDING</code></a>, and
496
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
497
><code class="literal">FALSE</code></a>. If <em class="parameter"><code>cancellable</code></em> was not <a
498
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
499
><code class="literal">NULL</code></a>, then the operation may have been
403
500
cancelled by triggering the cancellable object from another thread. If the operation
404
was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be set, and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be
501
was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED--CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be set, and <a
502
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
503
><code class="literal">FALSE</code></a> will be
406
507
<div class="variablelist"><table border="0">
407
508
<col align="left" valign="top">