GDataAccessHandler

typedef struct _GDataAccessHandler GDataAccessHandler;

All the fields in the GDataAccessHandler structure are private and should never be accessed directly.

Since 0.3.0

GDataAccessHandlerIface

typedef struct {
	GTypeInterface parent;

	gboolean (*is_owner_rule) (GDataAccessRule *rule);
} GDataAccessHandlerIface;

The class structure for the GDataAccessHandler interface.

Since 0.3.0

gdata_access_handler_get_rules ()

GDataFeed *         gdata_access_handler_get_rules      (GDataAccessHandler *self,
                                                         GDataService *service,
                                                         GCancellable *cancellable,
                                                         GDataQueryProgressCallback progress_callback,
                                                         gpointer progress_user_data,
                                                         GError **error);

Retrieves a GDataFeed containing all the access rules which apply to the given GDataAccessHandler. Only the owner of a GDataAccessHandler may view its rule feed.

If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

A GDATA_SERVICE_ERROR_WITH_QUERY will be returned if the server indicates there is a problem with the query.

For each rule in the response feed, progress_callback will be called in the main thread. If there was an error parsing the XML response, a GDataParserError will be returned.

Since 0.3.0

gdata_access_handler_insert_rule ()

GDataAccessRule *   gdata_access_handler_insert_rule    (GDataAccessHandler *self,
                                                         GDataService *service,
                                                         GDataAccessRule *rule,
                                                         GCancellable *cancellable,
                                                         GError **error);

Inserts rule in the access control list of the GDataAccessHandler.

The service will return an updated version of the rule, 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, the error G_IO_ERROR_CANCELLED will be returned.

If the rule is marked as already having been inserted a GDATA_SERVICE_ERROR_ENTRY_ALREADY_INSERTED error will be returned immediately (there will be no network requests).

If there is an error inserting the rule, a GDATA_SERVICE_ERROR_WITH_INSERTION error will be returned.

Since 0.3.0

gdata_access_handler_update_rule ()

GDataAccessRule *   gdata_access_handler_update_rule    (GDataAccessHandler *self,
                                                         GDataService *service,
                                                         GDataAccessRule *rule,
                                                         GCancellable *cancellable,
                                                         GError **error);

Updates rule in the access control list of the GDataAccessHandler.

The service will return an updated version of the rule, 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, the error G_IO_ERROR_CANCELLED will be returned.

If there is an error updating the rule, a GDATA_SERVICE_ERROR_WITH_UPDATE error will be returned.

Since 0.3.0

gdata_access_handler_delete_rule ()

gboolean            gdata_access_handler_delete_rule    (GDataAccessHandler *self,
                                                         GDataService *service,
                                                         GDataAccessRule *rule,
                                                         GCancellable *cancellable,
                                                         GError **error);

Deletes rule from the access control list of the GDataAccessHandler.

If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

If there is an error deleting the rule, a GDATA_SERVICE_ERROR_WITH_DELETION error will be returned, unless the rule was the owner's rule; in which case, GDATA_SERVICE_ERROR_FORBIDDEN will be returned without any network activity.

Since 0.3.0