create_resource


Description:

public virtual async bool create_resource (Source source, Cancellable? cancellable) throws Error

Asynchronously creates a server-side resource described by source.

For example, if source describes a new calendar, an equivalent calendar is created on the server.

It is the implementor's responsibility to examine source and determine what the equivalent server-side resource would be. If this cannot be determined without ambiguity, the function must return an error.

After the server-side resource is successfully created, the implementor must also add an Source to this's server. This can either be done immediately or in response to some "resource created" notification from the server. The added Source can be source itself or a different Source instance that describes the new resource.

When the operation is finished, callback will be called. You can then call create_resource.end to get the result of the operation.

Parameters:

this

an CollectionBackend

source

an Source

cancellable

optional Cancellable object, or null

callback

a TaskReadyCallback to call when the request is satisfied

user_data

data to pass to the callback function