galago_service_get_id ()

const char *
galago_service_get_id (const GalagoService *service);

Returns a service's ID.

galago_service_get_name ()

const char *
galago_service_get_name (const GalagoService *service);

Returns a service's name.

galago_service_get_flags ()

GalagoServiceFlags
galago_service_get_flags (const GalagoService *service);

Returns a service's flags.

galago_service_create_account ()

GalagoAccount *
galago_service_create_account (GalagoService *service,
                               GalagoPerson *person,
                               const char *username);

Creates an account belonging to this service.

If the account already exists, the existing account will be returned.

galago_service_get_account ()

GalagoAccount *
galago_service_get_account (const GalagoService *service,
                            const char *username,
                            gboolean query);

Returns the account with the specified username from a service.

galago_service_get_account_async ()

GalagoCallHandle
galago_service_get_account_async (const GalagoService *service,
                                  const char *username,
                                  GalagoServiceAccountCb cb,
                                  gpointer user_data,
                                  GFreeFunc free_func);

Asynchronously retrieves the account with the specified username from a service.

For example:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

static void
account_received_cb(GalagoService *service,
                    GalagoAccount *account,
                    gpointer user_data)
{
}

static void
get_bob_account(GalagoService *service)
{
    GalagoCallHandle handle;

    handle = galago_service_get_account_async(service, "Bob",
                                              account_received_cb,
                                              NULL, NULL);
}

Since: 0.5.2

galago_service_get_accounts ()

GList *
galago_service_get_accounts (const GalagoService *service,
                             gboolean query);

Returns a list of all accounts in the service.

This may emit an account-added signal for every object that returns. If your code connects to this signal and calls galago_service_get_accounts() as a result, you will want to add a lock so that you don't end up with unwanted side-effects.

galago_service_normalize ()

char *
galago_service_normalize (const GalagoService *service,
                          const char *username);

Normalizes an account username based on the service's normalization flags.

enum GalagoServiceFlags

struct GalagoService

struct GalagoService;

GALAGO_DBUS_SERVICE_INTERFACE

#define GALAGO_DBUS_SERVICE_INTERFACE "org.freedesktop.Galago.Service"

GALAGO_SERVICE_ID_AIM

#define GALAGO_SERVICE_ID_AIM          "aim"

GALAGO_SERVICE_ID_GADUGADU

#define GALAGO_SERVICE_ID_GADUGADU     "gadugadu"

GALAGO_SERVICE_ID_GROUPWISE

#define GALAGO_SERVICE_ID_GROUPWISE    "groupwise"

GALAGO_SERVICE_ID_ICQ

#define GALAGO_SERVICE_ID_ICQ          "icq"

GALAGO_SERVICE_ID_IRC

#define GALAGO_SERVICE_ID_IRC          "irc"

GALAGO_SERVICE_ID_JABBER

#define GALAGO_SERVICE_ID_JABBER       "jabber"

GALAGO_SERVICE_ID_MSN

#define GALAGO_SERVICE_ID_MSN          "msn"

GALAGO_SERVICE_ID_NAPSTER

#define GALAGO_SERVICE_ID_NAPSTER      "napster"

GALAGO_SERVICE_ID_SILC

#define GALAGO_SERVICE_ID_SILC         "silc"

GALAGO_SERVICE_ID_TREPIA

#define GALAGO_SERVICE_ID_TREPIA       "trepia"

GALAGO_SERVICE_ID_YAHOO

#define GALAGO_SERVICE_ID_YAHOO        "yahoo"

GALAGO_SERVICE_ID_ZEPHYR

#define GALAGO_SERVICE_ID_ZEPHYR       "zephyr"

The “flags” property

  “flags”                    GalagoServiceFlags

The service flags.

Owner: GalagoService

Flags: Read / Write / Construct Only

The “id” property

  “id”                       char *

The service's unique ID.

Owner: GalagoService

Flags: Read / Write / Construct Only

Default value: NULL

The “name” property

  “name”                     char *

The service's name.

Owner: GalagoService

Flags: Read / Write / Construct Only

Default value: NULL

The “account-added” signal

void
user_function (GalagoService *service,
               gpointer       account,
               gpointer       user_data)

Emitted when an account is added to the service.

Flags: Action

The “account-removed” signal

void
user_function (GalagoService *service,
               gpointer       account,
               gpointer       user_data)

Emitted when an account is removed to the service.

Flags: Action