Service-side Account Manager interface: telepathy-glib API Reference Manual

Service-side Account Manager interface

Service-side Account Manager interface — GInterface for Telepathy AccountManager objects

Functions

void	tp_svc_account_manager_emit_account_removed ()
void	tp_svc_account_manager_emit_account_validity_changed ()
void	(*tp_svc_account_manager_create_account_impl) ()
void	tp_svc_account_manager_return_from_create_account ()
void	tp_svc_account_manager_implement_create_account ()

Signals

void	account-removed	Has Details
void	account-validity-changed	Has Details

Types and Values

	TpSvcAccountManager
	TpSvcAccountManagerClass

Object Hierarchy

    GInterface
    ╰── TpSvcAccountManager

Includes

#include <telepathy-glib/telepathy-glib-dbus.h>

Description

The TpSvcAccountManager interface (auto-generated from the Telepathy spec) makes it easier to export an object implementing the Telepathy AccountManager interface, with the correct method and signal signatures, and emit signals from that object in a type-safe way.

You don't need these interfaces unless you're implementing a Telepathy AccountManager, such as Mission Control.

Functions

tp_svc_account_manager_emit_account_removed ()

void
tp_svc_account_manager_emit_account_removed
                               (gpointer instance,
                                const gchar *arg_Account);

Type-safe wrapper around g_signal_emit to emit the AccountRemoved signal on interface org.freedesktop.Telepathy.AccountManager.

Parameters

instance	The object implementing this interface
arg_Account	const gchar * (FIXME, generate documentation)

tp_svc_account_manager_emit_account_validity_changed ()

void
tp_svc_account_manager_emit_account_validity_changed
                               (gpointer instance,
                                const gchar *arg_Account,
                                gboolean arg_Valid);

Type-safe wrapper around g_signal_emit to emit the AccountValidityChanged signal on interface org.freedesktop.Telepathy.AccountManager.

Parameters

instance	The object implementing this interface
arg_Account	const gchar * (FIXME, generate documentation)
arg_Valid	gboolean (FIXME, generate documentation)

tp_svc_account_manager_create_account_impl ()

void
(*tp_svc_account_manager_create_account_impl)
                               (TpSvcAccountManager *self,
                                const gchar *in_Connection_Manager,
                                const gchar *in_Protocol,
                                const gchar *in_Display_Name,
                                GHashTable *in_Parameters,
                                GHashTable *in_Properties,
                                DBusGMethodInvocation *context);

The signature of an implementation of the D-Bus method CreateAccount on interface org.freedesktop.Telepathy.AccountManager.

Parameters

self	The object implementing this interface
in_Connection_Manager	const gchar * (FIXME, generate documentation)
in_Protocol	const gchar * (FIXME, generate documentation)
in_Display_Name	const gchar * (FIXME, generate documentation)
in_Parameters	GHashTable * (FIXME, generate documentation)
in_Properties	GHashTable * (FIXME, generate documentation)
context	Used to return values or throw an error

tp_svc_account_manager_return_from_create_account ()

void
tp_svc_account_manager_return_from_create_account
                               (DBusGMethodInvocation *context,
                                const gchar *out_Account);

Return successfully by calling dbus_g_method_return(). This inline function exists only to provide type-safety.

Parameters

context	The D-Bus method invocation context
out_Account	const gchar * (FIXME, generate documentation)

tp_svc_account_manager_implement_create_account ()

void
tp_svc_account_manager_implement_create_account
                               (TpSvcAccountManagerClass *klass,
                                tp_svc_account_manager_create_account_impl impl);

Register an implementation for the CreateAccount method in the vtable of an implementation of this interface. To be called from the interface init function.

Parameters

klass	A class whose instances implement this interface
impl	A callback used to implement the CreateAccount D-Bus method

Types and Values

TpSvcAccountManager

typedef struct _TpSvcAccountManager TpSvcAccountManager;

Dummy typedef representing any implementation of this interface.

TpSvcAccountManagerClass

typedef struct _TpSvcAccountManagerClass TpSvcAccountManagerClass;

The class of TpSvcAccountManager.

In a full implementation of this interface (i.e. all methods implemented), the interface initialization function used in G_IMPLEMENT_INTERFACE() would typically look like this:

static void
implement_account_manager (gpointer klass,
    gpointer unused G_GNUC_UNUSED)
{
#define IMPLEMENT(x) tp_svc_account_manager_implement_##x (\
  klass, my_object_##x)
  IMPLEMENT (create_account);
#undef IMPLEMENT
}

Signal Details

The `“account-removed”` signal

void
user_function (TpSvcAccountManager *self,
               DBusGObjectPath     *arg_Account,
               gpointer             user_data)

The AccountRemoved D-Bus signal is emitted whenever this GObject signal is.

Parameters

self	an object
arg_Account	const gchar * (FIXME, generate documentation)
user_data	user data set when the signal handler was connected.

Flags: Has Details

The `“account-validity-changed”` signal

void
user_function (TpSvcAccountManager *self,
               DBusGObjectPath     *arg_Account,
               gboolean             arg_Valid,
               gpointer             user_data)

The AccountValidityChanged D-Bus signal is emitted whenever this GObject signal is.

Parameters

self	an object
arg_Account	const gchar * (FIXME, generate documentation)
arg_Valid	gboolean (FIXME, generate documentation)
user_data	user data set when the signal handler was connected.

Flags: Has Details