update_entry


Description:

[ Version ( since = "0.9.0" ) ]
public Entry update_entry (AuthorizationDomain? domain, Entry entry, Cancellable? cancellable = null) throws Error

Updates entry by PUTting it to its edit link's URI.

For more information about the concept of updating entries, see the online documentation for the GData protocol.

The service will return an updated version of the entry, which is the return value of this function on success.

If cancellable is not null, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled before or during network activity, the error CANCELLED will be returned. Cancellation has no effect after network activity has finished, however, and the update will return successfully (or return an error sent by the server) if it is first cancelled after network activity has finished. See the overview of cancellation for more details.

If there is an error updating the entry, a PROTOCOL_ERROR error will be returned. Currently, subclasses cannot cannot override this or provide more specific errors.

Parameters:

this

a Service

domain

the AuthorizationDomain the update operation falls under, or null

entry

the Entry to update

cancellable

optional Cancellable object, or null

Returns:

an updated Entry, or null; unref with unref