update_entry

Updates entry by PUTting it to its <literal>edit</literal> link's URI.

For more information about the concept of updating entries, see the <ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/basics.html#UpdatingEntry">online documentation</ulink> 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 g_io_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 <link linkend="cancellable-support">overview of cancellation</link> for more details.

If there is an error updating the entry, a gdata_service_error_protocol_error error will be returned. Currently, subclasses <emphasis>cannot</emphasis> 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