Function

GioTaskreport_error

since: 2.36

Declaration 

void
g_task_report_error (
  GObject* source_object,
  GAsyncReadyCallback callback,
  gpointer callback_data,
  gpointer source_tag,
  GError* error
)

Description

Creates a GTask and then immediately calls g_task_return_error() on it. Use this in the wrapper function of an asynchronous method when you want to avoid even calling the virtual method. You can then use g_async_result_is_tagged() in the finish method wrapper to check if the result there is tagged as having been created by the wrapper method, and deal with it appropriately if so.

See also g_task_report_new_error().

Available since: 2.36

Parameters

source_object

Type: GObject

The GObject that owns this task, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
callback

Type: GAsyncReadyCallback

A GAsyncReadyCallback.

callback_data

Type: gpointer

User data passed to callback.

The argument can be NULL.
The data is owned by the caller of the function.
source_tag

Type: gpointer

An opaque pointer indicating the source of this task.

The argument can be NULL.
The data is owned by the caller of the function.
error

Type: GError

Error to report.

The called function takes ownership of the data, and is responsible for freeing it.