Creates a new remote resource by picking out relevant details from scratch_source
.
The scratch_source
must be an Source with no DBusObject
. The this must be 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
.
this |
an Source |
scratch_source |
an Source describing the resource to create |
cancellable |
optional Cancellable object, or |
|