Method

EDataServerGDataSessiontasks_insert_sync

since: 3.46

Declaration [src]

gboolean
e_gdata_session_tasks_insert_sync (
  EGDataSession* self,
  const gchar* tasklist_id,
  JsonBuilder* task,
  const gchar* parent_task_id,
  const gchar* previous_task_id,
  JsonObject** out_inserted_task,
  GCancellable* cancellable,
  GError** error
)

Description [src]

Creates a new task task in the task list tasklist_id. The out_inserted_task should be freed with json_object_unref(), when no longer needed.

Available since: 3.46

Parameters

tasklist_id

Type: const gchar*

Id of a task list.

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
task

Type: JsonBuilder

A JsonBuilder with the task object.

The data is owned by the caller of the method.
parent_task_id

Type: const gchar*

Parent task identifier, or NULL to create at the top-level.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
previous_task_id

Type: const gchar*

Previous sibling task identifier, or NULL to create at the first position among its siblings.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
out_inserted_task

Type: JsonObject

The created task.

The argument will be set by the function.
The caller of the method takes ownership of the returned data, and is responsible for freeing it.
cancellable

Type: GCancellable

Optional GCancellable object, or NULL.

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

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will be left initialized to NULL by the method if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: gboolean

Whether succeeded.