EDataServer.Source.remote_create_sync

### Method

# EDataServer Sourceremote_create_sync

since: 3.6

#### Declaration [src]

    gboolean
    e_source_remote_create_sync (
      ESource* source,
      ESource* scratch_source,
      GCancellable* cancellable,
      GError** error
    )

#### Description [src]

Creates a new remote resource by picking out relevant details from `scratch_source`. The `scratch_source` must be an `ESource` with no `GDBusObject`. The `source` must be `ESource:remote-creatable`.

The details required to create the resource vary by `ECollectionBackend`, but in most cases the `scratch_source` need only define the resource type (address book, calendar, etc.), a display name for the resource, and possibly a server-side path or ID for the resource.

If an error occurs, the function will set `error` and return `FALSE`.

Available since: 3.6

#### Parameters

`scratch_source`

  Type: `ESource`

  An `ESource` describing the resource to create.

  The data is owned by the caller of the method.

`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`

`TRUE` on success, `FALSE` on error.