ZeitgeistDataSourceRegistry 3 ZEITGEIST-2.0 Library
ZeitgeistDataSourceRegistry Query the Zeitgeist Data-Source Registry extension

## Synopsis

    #define             ZEITGEIST_TYPE_DATA_SOURCE_REGISTRY
    void                zeitgeist_data_source_registry_get_data_sources
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);
    GPtrArray *         zeitgeist_data_source_registry_get_data_sources_finish
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);
    void                zeitgeist_data_source_registry_get_data_source_from_id
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             const gchar *unique_id,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);
    ZeitgeistDataSource * zeitgeist_data_source_registry_get_data_source_from_id_finish
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);
    void                zeitgeist_data_source_registry_register_data_source
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             ZeitgeistDataSource *data_source,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);
    gboolean            zeitgeist_data_source_registry_register_data_source_finish
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);
    void                zeitgeist_data_source_registry_set_data_source_enabled
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             const gchar *unique_id,
                                                             gboolean enabled,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);
    void                zeitgeist_data_source_registry_set_data_source_enabled_finish
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);
    ZeitgeistDataSourceRegistry * zeitgeist_data_source_registry_new
                                                            (void);
    struct              ZeitgeistDataSourceRegistry;
    struct              ZeitgeistDataSourceRegistryClass;
    void                zeitgeist_remote_registry_get_data_sources
                                                            (ZeitgeistRemoteRegistry *self,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);
    GVariant *          zeitgeist_remote_registry_get_data_sources_finish
                                                            (ZeitgeistRemoteRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);
    void                zeitgeist_remote_registry_register_data_source
                                                            (ZeitgeistRemoteRegistry *self,
                                                             const gchar *unique_id,
                                                             const gchar *name,
                                                             const gchar *description,
                                                             GVariant *event_templates,
                                                             GCancellable *cancellable,
                                                             const char *sender,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);
    gboolean            zeitgeist_remote_registry_register_data_source_finish
                                                            (ZeitgeistRemoteRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);
    void                zeitgeist_remote_registry_set_data_source_enabled
                                                            (ZeitgeistRemoteRegistry *self,
                                                             const gchar *unique_id,
                                                             gboolean enabled,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);
    void                zeitgeist_remote_registry_set_data_source_enabled_finish
                                                            (ZeitgeistRemoteRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);
    void                zeitgeist_remote_registry_get_data_source_from_id
                                                            (ZeitgeistRemoteRegistry *self,
                                                             const gchar *unique_id,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);
    GVariant *          zeitgeist_remote_registry_get_data_source_from_id_finish
                                                            (ZeitgeistRemoteRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);
                        ZeitgeistRemoteRegistry;
    struct              ZeitgeistRemoteRegistryIface;

## Object Hierarchy

      GObject
       +----ZeitgeistQueuedProxyWrapper
             +----ZeitgeistDataSourceRegistry

      GInterface
       +----ZeitgeistRemoteRegistry

## Prerequisites

ZeitgeistRemoteRegistry requires GObject.

## Signals

      "source-disconnected"                            : Run Last
      "source-enabled"                                 : Run Last
      "source-registered"                              : Run Last
      "data-source-disconnected"                       : Run Last
      "data-source-enabled"                            : Run Last
      "data-source-registered"                         : Run Last

## Description

The Zeitgeist engine maintains a publicly available list of recognized data-sources (components inserting information into Zeitgeist). ZeitgeistDataSourceRegistry is used to register new data sources, get information about them and gives the ability to enable or disable the data sources.

## Details

### ZEITGEIST_TYPE_DATA_SOURCE_REGISTRY

    #define ZEITGEIST_TYPE_DATA_SOURCE_REGISTRY (zeitgeist_data_source_registry_get_type ())

The type for ZeitgeistDataSourceRegistry.

ZEITGEIST_TYPE_DATA_SOURCE_REGISTRY

### zeitgeist_data_source_registry_get_data_sources ()

    void                zeitgeist_data_source_registry_get_data_sources
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);

See also: ``zeitgeist_data_source_registry_get_data_sources_finish()``

self :

  the ZeitgeistDataSourceRegistry instance

cancellable :

_callback_ :

  callback to call when the request is satisfied. [scope async]

_user_data_ :

  the data to pass to _callback_ function. [closure]

zeitgeist_data_source_registry_get_data_sources

### zeitgeist_data_source_registry_get_data_sources_finish ()

    GPtrArray *         zeitgeist_data_source_registry_get_data_sources_finish
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);

See also: ``zeitgeist_data_source_registry_get_data_sources()``

self :

  the ZeitgeistDataSourceRegistry instance

_res_ :

  a GAsyncResult

error :

  location to store the error occuring, or `NULL` to ignore

zeitgeist_data_source_registry_get_data_sources_finish

### zeitgeist_data_source_registry_get_data_source_from_id ()

    void                zeitgeist_data_source_registry_get_data_source_from_id
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             const gchar *unique_id,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);

See also: ``zeitgeist_data_source_registry_get_data_source_from_id_finish()``

self :

  the ZeitgeistDataSourceRegistry instance

unique_id :

cancellable :

_callback_ :

  callback to call when the request is satisfied. [scope async]

_user_data_ :

  the data to pass to _callback_ function. [closure]

zeitgeist_data_source_registry_get_data_source_from_id

### zeitgeist_data_source_registry_get_data_source_from_id_finish ()

    ZeitgeistDataSource * zeitgeist_data_source_registry_get_data_source_from_id_finish
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);

See also: ``zeitgeist_data_source_registry_get_data_source_from_id()``

self :

  the ZeitgeistDataSourceRegistry instance

_res_ :

  a GAsyncResult

error :

  location to store the error occuring, or `NULL` to ignore

zeitgeist_data_source_registry_get_data_source_from_id_finish

### zeitgeist_data_source_registry_register_data_source ()

    void                zeitgeist_data_source_registry_register_data_source
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             ZeitgeistDataSource *data_source,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);

See also: ``zeitgeist_data_source_registry_register_data_source_finish()``

self :

  the ZeitgeistDataSourceRegistry instance

data_source :

cancellable :

_callback_ :

  callback to call when the request is satisfied. [scope async]

_user_data_ :

  the data to pass to _callback_ function. [closure]

zeitgeist_data_source_registry_register_data_source

### zeitgeist_data_source_registry_register_data_source_finish ()

    gboolean            zeitgeist_data_source_registry_register_data_source_finish
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);

See also: ``zeitgeist_data_source_registry_register_data_source()``

self :

  the ZeitgeistDataSourceRegistry instance

_res_ :

  a GAsyncResult

error :

  location to store the error occuring, or `NULL` to ignore

zeitgeist_data_source_registry_register_data_source_finish

### zeitgeist_data_source_registry_set_data_source_enabled ()

    void                zeitgeist_data_source_registry_set_data_source_enabled
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             const gchar *unique_id,
                                                             gboolean enabled,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);

See also: ``zeitgeist_data_source_registry_set_data_source_enabled_finish()``

self :

  the ZeitgeistDataSourceRegistry instance

unique_id :

enabled :

cancellable :

_callback_ :

  callback to call when the request is satisfied. [scope async]

_user_data_ :

  the data to pass to _callback_ function. [closure]

zeitgeist_data_source_registry_set_data_source_enabled

### zeitgeist_data_source_registry_set_data_source_enabled_finish ()

    void                zeitgeist_data_source_registry_set_data_source_enabled_finish
                                                            (ZeitgeistDataSourceRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);

See also: ``zeitgeist_data_source_registry_set_data_source_enabled()``

self :

  the ZeitgeistDataSourceRegistry instance

_res_ :

  a GAsyncResult

error :

  location to store the error occuring, or `NULL` to ignore

zeitgeist_data_source_registry_set_data_source_enabled_finish

### zeitgeist_data_source_registry_new ()

    ZeitgeistDataSourceRegistry * zeitgeist_data_source_registry_new
                                                            (void);

zeitgeist_data_source_registry_new

### struct ZeitgeistDataSourceRegistry

    struct ZeitgeistDataSourceRegistry;

Query the Zeitgeist Data-Source Registry extension

The Zeitgeist engine maintains a publicly available list of recognized data-sources (components inserting information into Zeitgeist). ZeitgeistDataSourceRegistry is used to register new data sources, get information about them and gives the ability to enable or disable the data sources.

ZeitgeistDataSourceRegistry

### struct ZeitgeistDataSourceRegistryClass

    struct ZeitgeistDataSourceRegistryClass {
    	ZeitgeistQueuedProxyWrapperClass parent_class;
    };

The class structure for `ZEITGEIST_TYPE_DATA_SOURCE_REGISTRY`. All the fields in this structure are private and should never be accessed directly.

ZeitgeistQueuedProxyWrapperClass parent_class;

  the parent class structure

ZeitgeistDataSourceRegistryClass

### zeitgeist_remote_registry_get_data_sources ()

    void                zeitgeist_remote_registry_get_data_sources
                                                            (ZeitgeistRemoteRegistry *self,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);

See also: ``zeitgeist_remote_registry_get_data_sources_finish()``

self :

  the ZeitgeistRemoteRegistry instance

cancellable :

_callback_ :

  callback to call when the request is satisfied. [scope async]

_user_data_ :

  the data to pass to _callback_ function. [closure]

zeitgeist_remote_registry_get_data_sources

### zeitgeist_remote_registry_get_data_sources_finish ()

    GVariant *          zeitgeist_remote_registry_get_data_sources_finish
                                                            (ZeitgeistRemoteRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);

See also: ``zeitgeist_remote_registry_get_data_sources()``

self :

  the ZeitgeistRemoteRegistry instance

_res_ :

  a GAsyncResult

error :

  location to store the error occuring, or `NULL` to ignore

zeitgeist_remote_registry_get_data_sources_finish

### zeitgeist_remote_registry_register_data_source ()

    void                zeitgeist_remote_registry_register_data_source
                                                            (ZeitgeistRemoteRegistry *self,
                                                             const gchar *unique_id,
                                                             const gchar *name,
                                                             const gchar *description,
                                                             GVariant *event_templates,
                                                             GCancellable *cancellable,
                                                             const char *sender,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);

See also: ``zeitgeist_remote_registry_register_data_source_finish()``

self :

  the ZeitgeistRemoteRegistry instance

unique_id :

name :

description :

event_templates :

cancellable :

sender :

_callback_ :

  callback to call when the request is satisfied. [scope async]

_user_data_ :

  the data to pass to _callback_ function. [closure]

zeitgeist_remote_registry_register_data_source

### zeitgeist_remote_registry_register_data_source_finish ()

    gboolean            zeitgeist_remote_registry_register_data_source_finish
                                                            (ZeitgeistRemoteRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);

See also: ``zeitgeist_remote_registry_register_data_source()``

self :

  the ZeitgeistRemoteRegistry instance

_res_ :

  a GAsyncResult

error :

  location to store the error occuring, or `NULL` to ignore

zeitgeist_remote_registry_register_data_source_finish

### zeitgeist_remote_registry_set_data_source_enabled ()

    void                zeitgeist_remote_registry_set_data_source_enabled
                                                            (ZeitgeistRemoteRegistry *self,
                                                             const gchar *unique_id,
                                                             gboolean enabled,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);

See also: ``zeitgeist_remote_registry_set_data_source_enabled_finish()``

self :

  the ZeitgeistRemoteRegistry instance

unique_id :

enabled :

cancellable :

_callback_ :

  callback to call when the request is satisfied. [scope async]

_user_data_ :

  the data to pass to _callback_ function. [closure]

zeitgeist_remote_registry_set_data_source_enabled

### zeitgeist_remote_registry_set_data_source_enabled_finish ()

    void                zeitgeist_remote_registry_set_data_source_enabled_finish
                                                            (ZeitgeistRemoteRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);

See also: ``zeitgeist_remote_registry_set_data_source_enabled()``

self :

  the ZeitgeistRemoteRegistry instance

_res_ :

  a GAsyncResult

error :

  location to store the error occuring, or `NULL` to ignore

zeitgeist_remote_registry_set_data_source_enabled_finish

### zeitgeist_remote_registry_get_data_source_from_id ()

    void                zeitgeist_remote_registry_get_data_source_from_id
                                                            (ZeitgeistRemoteRegistry *self,
                                                             const gchar *unique_id,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback _callback_,
                                                             gpointer _user_data_);

See also: ``zeitgeist_remote_registry_get_data_source_from_id_finish()``

self :

  the ZeitgeistRemoteRegistry instance

unique_id :

cancellable :

_callback_ :

  callback to call when the request is satisfied. [scope async]

_user_data_ :

  the data to pass to _callback_ function. [closure]

zeitgeist_remote_registry_get_data_source_from_id

### zeitgeist_remote_registry_get_data_source_from_id_finish ()

    GVariant *          zeitgeist_remote_registry_get_data_source_from_id_finish
                                                            (ZeitgeistRemoteRegistry *self,
                                                             GAsyncResult *_res_,
                                                             GError **error);

See also: ``zeitgeist_remote_registry_get_data_source_from_id()``

self :

  the ZeitgeistRemoteRegistry instance

_res_ :

  a GAsyncResult

error :

  location to store the error occuring, or `NULL` to ignore

zeitgeist_remote_registry_get_data_source_from_id_finish

### ZeitgeistRemoteRegistry

    typedef struct _ZeitgeistRemoteRegistry ZeitgeistRemoteRegistry;

ZeitgeistRemoteRegistry

### struct ZeitgeistRemoteRegistryIface

    struct ZeitgeistRemoteRegistryIface {
    	GTypeInterface parent_iface;
    	void (*get_data_sources) (ZeitgeistRemoteRegistry* self, GCancellable* cancellable, GAsyncReadyCallback _callback_, gpointer _user_data_);
    	GVariant* (*get_data_sources_finish) (ZeitgeistRemoteRegistry* self, GAsyncResult* _res_, GError** error);
    	void (*register_data_source) (ZeitgeistRemoteRegistry* self, const gchar* unique_id, const gchar* name, const gchar* description, GVariant* event_templates, GCancellable* cancellable, const char* sender, GAsyncReadyCallback _callback_, gpointer _user_data_);
    	gboolean (*register_data_source_finish) (ZeitgeistRemoteRegistry* self, GAsyncResult* _res_, GError** error);
    	void (*set_data_source_enabled) (ZeitgeistRemoteRegistry* self, const gchar* unique_id, gboolean enabled, GCancellable* cancellable, GAsyncReadyCallback _callback_, gpointer _user_data_);
    	void (*set_data_source_enabled_finish) (ZeitgeistRemoteRegistry* self, GAsyncResult* _res_, GError** error);
    	void (*get_data_source_from_id) (ZeitgeistRemoteRegistry* self, const gchar* unique_id, GCancellable* cancellable, GAsyncReadyCallback _callback_, gpointer _user_data_);
    	GVariant* (*get_data_source_from_id_finish) (ZeitgeistRemoteRegistry* self, GAsyncResult* _res_, GError** error);
    };

Interface for creating ZeitgeistRemoteRegistry implementations.

GTypeInterface parent_iface;

  the parent interface structure

get_data_sources ()

  virtual method called by ``zeitgeist_remote_registry_get_data_sources()``

get_data_sources_finish ()

  asynchronous finish function for get_data_sources, called by ``zeitgeist_remote_registry_get_data_sources()``

register_data_source ()

  virtual method called by ``zeitgeist_remote_registry_register_data_source()``

register_data_source_finish ()

  asynchronous finish function for register_data_source, called by ``zeitgeist_remote_registry_register_data_source()``

set_data_source_enabled ()

  virtual method called by ``zeitgeist_remote_registry_set_data_source_enabled()``

set_data_source_enabled_finish ()

  asynchronous finish function for set_data_source_enabled, called by ``zeitgeist_remote_registry_set_data_source_enabled()``

get_data_source_from_id ()

  virtual method called by ``zeitgeist_remote_registry_get_data_source_from_id()``

get_data_source_from_id_finish ()

  asynchronous finish function for get_data_source_from_id, called by ``zeitgeist_remote_registry_get_data_source_from_id()``

ZeitgeistRemoteRegistryIface

## Signal Details

### The `"source-disconnected"` signal

    void                user_function                      (ZeitgeistDataSourceRegistry *data_source_registry,
                                                            ZeitgeistDataSource         *data_source,
                                                            gpointer                     user_data)                 : Run Last

data_source_registry :

  the ZeitgeistDataSourceRegistry instance that received the signal

data_source :

user_data :

  user data set when the signal handler was connected.

ZeitgeistDataSourceRegistry::source-disconnected

### The `"source-enabled"` signal

    void                user_function                      (ZeitgeistDataSourceRegistry *data_source_registry,
                                                            gchar                       *unique_id,
                                                            gboolean                     enabled,
                                                            gpointer                     user_data)                 : Run Last

data_source_registry :

  the ZeitgeistDataSourceRegistry instance that received the signal

unique_id :

enabled :

user_data :

  user data set when the signal handler was connected.

ZeitgeistDataSourceRegistry::source-enabled

### The `"source-registered"` signal

    void                user_function                      (ZeitgeistDataSourceRegistry *data_source_registry,
                                                            ZeitgeistDataSource         *data_source,
                                                            gpointer                     user_data)                 : Run Last

data_source_registry :

  the ZeitgeistDataSourceRegistry instance that received the signal

data_source :

user_data :

  user data set when the signal handler was connected.

ZeitgeistDataSourceRegistry::source-registered

### The `"data-source-disconnected"` signal

    void                user_function                      (ZeitgeistRemoteRegistry *remote_registry,
                                                            GVariant                *data_source,
                                                            gpointer                 user_data)            : Run Last

remote_registry :

  the ZeitgeistRemoteRegistry instance that received the signal

data_source :

user_data :

  user data set when the signal handler was connected.

ZeitgeistRemoteRegistry::data-source-disconnected

### The `"data-source-enabled"` signal

    void                user_function                      (ZeitgeistRemoteRegistry *remote_registry,
                                                            gchar                   *unique_id,
                                                            gboolean                 enabled,
                                                            gpointer                 user_data)            : Run Last

remote_registry :

  the ZeitgeistRemoteRegistry instance that received the signal

unique_id :

enabled :

user_data :

  user data set when the signal handler was connected.

ZeitgeistRemoteRegistry::data-source-enabled

### The `"data-source-registered"` signal

    void                user_function                      (ZeitgeistRemoteRegistry *remote_registry,
                                                            GVariant                *data_source,
                                                            gpointer                 user_data)            : Run Last

remote_registry :

  the ZeitgeistRemoteRegistry instance that received the signal

data_source :

user_data :

  user data set when the signal handler was connected.

ZeitgeistRemoteRegistry::data-source-registered