39
40
<td valign="top" align="right"></td>
40
41
</tr></table></div>
41
<div class="refsynopsisdiv">
42
<div class="refsynopsisdiv" title="Synopsis">
42
43
<a name="libbrasero-burn-brasero-status.synopsis"></a><h2>Synopsis</h2>
43
<pre class="synopsis">
45
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
48
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatusType"
49
>BraseroStatusType</a>;
51
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
52
>BraseroStatus</a> * <a
53
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-new"
54
>brasero_status_new</a> (void);
56
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-free"
57
>brasero_status_free</a> (<a
58
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
59
>BraseroStatus</a> *status);
61
href="../libbrasero-burn/libbrasero-burn-brasero-enums.html#BraseroBurnResult"
62
>BraseroBurnResult</a> <a
63
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-get-result"
64
>brasero_status_get_result</a> (<a
65
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
66
>BraseroStatus</a> *status);
68
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
70
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-get-progress"
71
>brasero_status_get_progress</a> (<a
72
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
73
>BraseroStatus</a> *status);
75
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
77
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-get-error"
78
>brasero_status_get_error</a> (<a
79
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
80
>BraseroStatus</a> *status);
82
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
84
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-get-current-action"
85
>brasero_status_get_current_action</a> (<a
86
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
87
>BraseroStatus</a> *status);
89
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-set-completed"
90
>brasero_status_set_completed</a> (<a
91
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
92
>BraseroStatus</a> *status);
94
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-set-not-ready"
95
>brasero_status_set_not_ready</a> (<a
96
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
97
>BraseroStatus</a> *status,
99
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
100
>gdouble</a> progress,
102
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
103
>gchar</a> *current_action);
105
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-set-error"
106
>brasero_status_set_error</a> (<a
107
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
108
>BraseroStatus</a> *status,
110
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
44
<pre class="synopsis"> <a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a>;
45
enum <a href="libbrasero-burn-brasero-status.html#BraseroStatusType">BraseroStatusType</a>;
46
<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> * <a href="libbrasero-burn-brasero-status.html#brasero-status-new">brasero_status_new</a> (void);
47
void <a href="libbrasero-burn-brasero-status.html#brasero-status-free">brasero_status_free</a> (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);
48
<a href="libbrasero-burn-brasero-enums.html#BraseroBurnResult">BraseroBurnResult</a> <a href="libbrasero-burn-brasero-status.html#brasero-status-get-result">brasero_status_get_result</a> (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);
49
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble">gdouble</a> <a href="libbrasero-burn-brasero-status.html#brasero-status-get-progress">brasero_status_get_progress</a> (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);
50
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> * <a href="libbrasero-burn-brasero-status.html#brasero-status-get-error">brasero_status_get_error</a> (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);
51
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * <a href="libbrasero-burn-brasero-status.html#brasero-status-get-current-action">brasero_status_get_current_action</a> (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);
52
void <a href="libbrasero-burn-brasero-status.html#brasero-status-set-completed">brasero_status_set_completed</a> (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);
53
void <a href="libbrasero-burn-brasero-status.html#brasero-status-set-not-ready">brasero_status_set_not_ready</a> (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status,
54
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble">gdouble</a> progress,
55
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *current_action);
56
void <a href="libbrasero-burn-brasero-status.html#brasero-status-set-error">brasero_status_set_error</a> (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status,
57
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error);
114
<div class="refsect1" lang="en">
60
<div class="refsect1" title="Description">
115
61
<a name="libbrasero-burn-brasero-status.description"></a><h2>Description</h2>
119
<div class="refsect1" lang="en">
65
<div class="refsect1" title="Details">
120
66
<a name="libbrasero-burn-brasero-status.details"></a><h2>Details</h2>
121
<div class="refsect2" lang="en">
67
<div class="refsect2" title="BraseroStatus">
122
68
<a name="BraseroStatus"></a><h3>BraseroStatus</h3>
123
69
<pre class="programlisting">typedef struct _BraseroStatus BraseroStatus;</pre>
128
<div class="refsect2" lang="en">
74
<div class="refsect2" title="enum BraseroStatusType">
129
75
<a name="BraseroStatusType"></a><h3>enum BraseroStatusType</h3>
130
76
<pre class="programlisting">typedef enum {
131
77
BRASERO_STATUS_OK = 0,
141
<div class="refsect2" lang="en">
87
<div class="refsect2" title="brasero_status_new ()">
142
88
<a name="brasero-status-new"></a><h3>brasero_status_new ()</h3>
143
<pre class="programlisting"><a
144
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
145
>BraseroStatus</a> * brasero_status_new (void);</pre>
148
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
149
><span class="type">BraseroStatus</span></a> structure.
151
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-free"
152
><code class="function">brasero_status_free()</code></a>.</p>
89
<pre class="programlisting"><a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> * brasero_status_new (void);</pre>
91
Creates a new <a href="libbrasero-burn-brasero-status.html#BraseroStatus"><span class="type">BraseroStatus</span></a> structure.
92
Free it with <a href="libbrasero-burn-brasero-status.html#brasero-status-free"><code class="function">brasero_status_free()</code></a>.</p>
155
93
<div class="variablelist"><table border="0">
156
94
<col align="left" valign="top">
158
96
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
160
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
161
><span class="type">BraseroStatus</span></a> pointer.
97
<td> a <a href="libbrasero-burn-brasero-status.html#BraseroStatus"><span class="type">BraseroStatus</span></a> pointer.
167
<div class="refsect2" lang="en">
103
<div class="refsect2" title="brasero_status_free ()">
168
104
<a name="brasero-status-free"></a><h3>brasero_status_free ()</h3>
169
<pre class="programlisting">void brasero_status_free (<a
170
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
171
>BraseroStatus</a> *status);</pre>
174
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
175
><span class="type">BraseroStatus</span></a> structure.</p>
105
<pre class="programlisting">void brasero_status_free (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);</pre>
107
Frees <a href="libbrasero-burn-brasero-status.html#BraseroStatus"><span class="type">BraseroStatus</span></a> structure.</p>
178
108
<div class="variablelist"><table border="0">
179
109
<col align="left" valign="top">
181
111
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
183
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
184
><span class="type">BraseroStatus</span></a>.
112
<td> a <a href="libbrasero-burn-brasero-status.html#BraseroStatus"><span class="type">BraseroStatus</span></a>.
190
<div class="refsect2" lang="en">
118
<div class="refsect2" title="brasero_status_get_result ()">
191
119
<a name="brasero-status-get-result"></a><h3>brasero_status_get_result ()</h3>
192
<pre class="programlisting"><a
193
href="../libbrasero-burn/libbrasero-burn-brasero-enums.html#BraseroBurnResult"
194
>BraseroBurnResult</a> brasero_status_get_result (<a
195
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
196
>BraseroStatus</a> *status);</pre>
120
<pre class="programlisting"><a href="libbrasero-burn-brasero-enums.html#BraseroBurnResult">BraseroBurnResult</a> brasero_status_get_result (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);</pre>
198
122
After an object (see <code class="function">brasero_burn_track_get_status()</code>) has
199
123
been requested its status, this function returns that status.</p>
202
124
<div class="variablelist"><table border="0">
203
125
<col align="left" valign="top">
206
128
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
208
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
209
><span class="type">BraseroStatus</span></a>.
129
<td> a <a href="libbrasero-burn-brasero-status.html#BraseroStatus"><span class="type">BraseroStatus</span></a>.
213
133
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
215
href="../libbrasero-burn/libbrasero-burn-brasero-enums.html#BraseroBurnResult"
216
><span class="type">BraseroBurnResult</span></a>.
134
<td> a <a href="libbrasero-burn-brasero-enums.html#BraseroBurnResult"><span class="type">BraseroBurnResult</span></a>.
217
135
BRASERO_BURN_OK if the object is ready.
218
136
BRASERO_BURN_NOT_READY if some time should be given to the object before it is ready.
219
137
BRASERO_BURN_ERR if there is an error.
226
<div class="refsect2" lang="en">
144
<div class="refsect2" title="brasero_status_get_progress ()">
227
145
<a name="brasero-status-get-progress"></a><h3>brasero_status_get_progress ()</h3>
228
<pre class="programlisting"><a
229
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
230
>gdouble</a> brasero_status_get_progress (<a
231
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
232
>BraseroStatus</a> *status);</pre>
146
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble">gdouble</a> brasero_status_get_progress (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);</pre>
235
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-get-result"
236
><code class="function">brasero_status_get_result()</code></a> returned BRASERO_BURN_NOT_READY,
148
If <a href="libbrasero-burn-brasero-status.html#brasero-status-get-result"><code class="function">brasero_status_get_result()</code></a> returned BRASERO_BURN_NOT_READY,
237
149
this function returns the progress regarding the operation completion.</p>
240
150
<div class="variablelist"><table border="0">
241
151
<col align="left" valign="top">
244
154
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
246
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
247
><span class="type">BraseroStatus</span></a>.
155
<td> a <a href="libbrasero-burn-brasero-status.html#BraseroStatus"><span class="type">BraseroStatus</span></a>.
251
159
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
253
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
254
><span class="type">gdouble</span></a>
160
<td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a>
261
<div class="refsect2" lang="en">
167
<div class="refsect2" title="brasero_status_get_error ()">
262
168
<a name="brasero-status-get-error"></a><h3>brasero_status_get_error ()</h3>
263
<pre class="programlisting"><a
264
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
265
>GError</a> * brasero_status_get_error (<a
266
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
267
>BraseroStatus</a> *status);</pre>
169
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> * brasero_status_get_error (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);</pre>
270
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-get-result"
271
><code class="function">brasero_status_get_result()</code></a> returned BRASERO_BURN_ERR,
171
If <a href="libbrasero-burn-brasero-status.html#brasero-status-get-result"><code class="function">brasero_status_get_result()</code></a> returned BRASERO_BURN_ERR,
272
172
this function returns the error.</p>
275
173
<div class="variablelist"><table border="0">
276
174
<col align="left" valign="top">
279
177
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
281
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
282
><span class="type">BraseroStatus</span></a>.
178
<td> a <a href="libbrasero-burn-brasero-status.html#BraseroStatus"><span class="type">BraseroStatus</span></a>.
286
182
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
288
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
289
><span class="type">GError</span></a>
183
<td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>
296
<div class="refsect2" lang="en">
190
<div class="refsect2" title="brasero_status_get_current_action ()">
297
191
<a name="brasero-status-get-current-action"></a><h3>brasero_status_get_current_action ()</h3>
298
<pre class="programlisting"><a
299
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
300
>gchar</a> * brasero_status_get_current_action (<a
301
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
302
>BraseroStatus</a> *status);</pre>
192
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * brasero_status_get_current_action (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);</pre>
305
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#brasero-status-get-result"
306
><code class="function">brasero_status_get_result()</code></a> returned BRASERO_BURN_NOT_READY,
194
If <a href="libbrasero-burn-brasero-status.html#brasero-status-get-result"><code class="function">brasero_status_get_result()</code></a> returned BRASERO_BURN_NOT_READY,
307
195
this function returns a string describing the operation currently performed.
308
196
Free the string when it is not needed anymore.</p>
311
197
<div class="variablelist"><table border="0">
312
198
<col align="left" valign="top">
315
201
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
317
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
318
><span class="type">BraseroStatus</span></a>.
202
<td> a <a href="libbrasero-burn-brasero-status.html#BraseroStatus"><span class="type">BraseroStatus</span></a>.
322
206
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
324
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
325
><span class="type">gchar</span></a>.
207
<td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>.
332
<div class="refsect2" lang="en">
214
<div class="refsect2" title="brasero_status_set_completed ()">
333
215
<a name="brasero-status-set-completed"></a><h3>brasero_status_set_completed ()</h3>
334
<pre class="programlisting">void brasero_status_set_completed (<a
335
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
336
>BraseroStatus</a> *status);</pre>
216
<pre class="programlisting">void brasero_status_set_completed (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status);</pre>
338
218
Sets the status for a request to BRASERO_BURN_OK.</p>
341
219
<div class="variablelist"><table border="0">
342
220
<col align="left" valign="top">
344
222
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
346
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
347
><span class="type">BraseroStatus</span></a>.
223
<td> a <a href="libbrasero-burn-brasero-status.html#BraseroStatus"><span class="type">BraseroStatus</span></a>.
353
<div class="refsect2" lang="en">
229
<div class="refsect2" title="brasero_status_set_not_ready ()">
354
230
<a name="brasero-status-set-not-ready"></a><h3>brasero_status_set_not_ready ()</h3>
355
<pre class="programlisting">void brasero_status_set_not_ready (<a
356
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
357
>BraseroStatus</a> *status,
359
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
360
>gdouble</a> progress,
362
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
363
>gchar</a> *current_action);</pre>
231
<pre class="programlisting">void brasero_status_set_not_ready (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status,
232
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble">gdouble</a> progress,
233
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *current_action);</pre>
365
235
Sets the status for a request to BRASERO_BURN_NOT_READY.
366
236
Allows to set a string describing the operation currently performed
367
237
as well as the progress regarding the operation completion.</p>
370
238
<div class="variablelist"><table border="0">
371
239
<col align="left" valign="top">
374
242
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
376
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
377
><span class="type">BraseroStatus</span></a>.
243
<td> a <a href="libbrasero-burn-brasero-status.html#BraseroStatus"><span class="type">BraseroStatus</span></a>.
381
247
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
383
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
384
><span class="type">gdouble</span></a> or -1.0.
248
<td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> or -1.0.
388
252
<td><p><span class="term"><em class="parameter"><code>current_action</code></em> :</span></p></td>
390
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
391
><span class="type">gchar</span></a> or NULL.
253
<td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> or NULL.
398
<div class="refsect2" lang="en">
260
<div class="refsect2" title="brasero_status_set_error ()">
399
261
<a name="brasero-status-set-error"></a><h3>brasero_status_set_error ()</h3>
400
<pre class="programlisting">void brasero_status_set_error (<a
401
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
402
>BraseroStatus</a> *status,
404
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
405
>GError</a> *error);</pre>
262
<pre class="programlisting">void brasero_status_set_error (<a href="libbrasero-burn-brasero-status.html#BraseroStatus">BraseroStatus</a> *status,
263
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> *error);</pre>
407
265
Sets the status for a request to BRASERO_BURN_ERR.</p>
410
266
<div class="variablelist"><table border="0">
411
267
<col align="left" valign="top">
414
270
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
416
href="../libbrasero-burn/libbrasero-burn-brasero-status.html#BraseroStatus"
417
><span class="type">BraseroStatus</span></a>.
271
<td> a <a href="libbrasero-burn-brasero-status.html#BraseroStatus"><span class="type">BraseroStatus</span></a>.
421
275
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
423
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
424
><span class="type">GError</span></a> or NULL.
276
<td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> or NULL.