Top | ![]() |
![]() |
![]() |
![]() |
const char * | galago_service_get_id () |
const char * | galago_service_get_name () |
GalagoServiceFlags | galago_service_get_flags () |
GalagoAccount * | galago_service_create_account () |
GalagoAccount * | galago_service_get_account () |
GalagoCallHandle | galago_service_get_account_async () |
GList * | galago_service_get_accounts () |
char * | galago_service_normalize () |
GalagoServiceFlags | flags | Read / Write / Construct Only |
gchar * | id | Read / Write / Construct Only |
gchar * | name | Read / Write / Construct Only |
enum | GalagoServiceFlags |
struct | GalagoService |
#define | GALAGO_DBUS_SERVICE_INTERFACE |
#define | GALAGO_SERVICE_ID_AIM |
#define | GALAGO_SERVICE_ID_GADUGADU |
#define | GALAGO_SERVICE_ID_GROUPWISE |
#define | GALAGO_SERVICE_ID_ICQ |
#define | GALAGO_SERVICE_ID_IRC |
#define | GALAGO_SERVICE_ID_JABBER |
#define | GALAGO_SERVICE_ID_MSN |
#define | GALAGO_SERVICE_ID_NAPSTER |
#define | GALAGO_SERVICE_ID_SILC |
#define | GALAGO_SERVICE_ID_TREPIA |
#define | GALAGO_SERVICE_ID_YAHOO |
#define | GALAGO_SERVICE_ID_ZEPHYR |
GalagoService represents a service of some kind, typically used for messaging or VoIP. It owns a list of GalagoAccounts, and contains rules determining how account usernames should be normalized and compared.
GalagoServices are created through galago_create_service()
.
By default, account usernames are converted to lowercase and all spaces are removed when normalizing them for comparison. GalagoServiceFlags can change this behavior.
const char *
galago_service_get_id (const GalagoService *service
);
Returns a service's ID.
const char *
galago_service_get_name (const GalagoService *service
);
Returns a service's name.
GalagoServiceFlags
galago_service_get_flags (const GalagoService *service
);
Returns a service's flags.
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.
GalagoAccount * galago_service_get_account (const GalagoService *service
,const char *username
,gboolean query
);
Returns the account with the specified username from a service.
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); } |
service |
The service. |
|
username |
The account's username. |
|
cb |
The callback function that will be passed the account. |
|
user_data |
Custom data to pass to the callback function. |
|
free_func |
Optional function to free |
Since: 0.5.2
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.
char * galago_service_normalize (const GalagoService *service
,const char *username
);
Normalizes an account username based on the service's normalization flags.
A list of flags specifying rules for the service. Currently this consists of flags dictating how account usernames should be normalized when comparing the usernames.
struct GalagoService;
This is an opaque structure representing a service. This should not be used directly. Use the accessor functions below.
#define GALAGO_DBUS_SERVICE_INTERFACE "org.freedesktop.Galago.Service"
The D-BUS interface that GalagoService maps to.
“flags”
property“flags” GalagoServiceFlags
The service flags.
Flags: Read / Write / Construct Only
“id”
property “id” gchar *
The service's unique ID.
Flags: Read / Write / Construct Only
Default value: NULL
“account-added”
signalvoid user_function (GalagoService *service, gpointer account, gpointer user_data)
Emitted when an account is added to the service.
service |
The object which received the signal. |
|
account |
The account that was added. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Action
“account-removed”
signalvoid user_function (GalagoService *service, gpointer account, gpointer user_data)
Emitted when an account is removed to the service.
service |
The object which received the signal. |
|
account |
The account that was removed. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Action