Service-side Account Manager interface

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

Functions

Signals

void account-removed Has Details
void account-usability-changed Has Details

Types and Values

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 im.telepathy.v1.AccountManager.

Parameters

instance

The object implementing this interface

 

arg_Account

const gchar * (FIXME, generate documentation)

 

tp_svc_account_manager_emit_account_usability_changed ()

void
tp_svc_account_manager_emit_account_usability_changed
                               (gpointer instance,
                                const gchar *arg_Account,
                                gboolean arg_Usable);

Type-safe wrapper around g_signal_emit to emit the AccountUsabilityChanged signal on interface im.telepathy.v1.AccountManager.

Parameters

instance

The object implementing this interface

 

arg_Account

const gchar * (FIXME, generate documentation)

 

arg_Usable

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,
                                GDBusMethodInvocation *invocation);

The signature of an implementation of the D-Bus method CreateAccount on interface im.telepathy.v1.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)

 

invocation

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
                               (GDBusMethodInvocation *invocation,
                                const gchar *out_Account);

Return successfully by calling g_dbus_method_invocation_return_value().

Parameters

invocation

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-usability-changed” signal

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

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

Parameters

self

an object

 

arg_Account

const gchar * (FIXME, generate documentation)

 

arg_Usable

gboolean (FIXME, generate documentation)

 

user_data

user data set when the signal handler was connected.

 

Flags: Has Details