get_rules


Description:

public abstract Feed get_rules (Service service, Cancellable? cancellable, QueryProgressCallback? progress_callback) throws Error

Retrieves a Feed containing all the access rules which apply to the given AccessHandler.

Only the owner of a AccessHandler 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 CANCELLED will be returned.

A PROTOCOL_ERROR 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 ParserError will be returned.

Parameters:

this

a AccessHandler

service

a Service

cancellable

optional Cancellable object, or null

progress_callback

a QueryProgressCallback to call when a rule is loaded, or null

progress_user_data

data to pass to the progress_callback function

Returns:

a Feed of access control rules, or null; unref with unref