|
|
|
Mission Control Plugins Reference Manual | |
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Prerequisites | ||||
McpAccountManagerMcpAccountManager — Object representing the account manager, implemented by Mission Control |
#include <mission-control-plugins/mission-control-plugins.h>
McpAccountManager;
McpAccountManagerIface;
gchar * mcp_account_manager_get_unique_name (McpAccountManager *mcpa,
const gchar *manager,
const gchar *protocol,
const GHashTable *params);
gchar * mcp_account_manager_get_value (const McpAccountManager *mcpa,
const gchar *account,
const gchar *key);
GStrv mcp_account_manager_list_keys (const McpAccountManager *mcpa,
const gchar *account);
gboolean mcp_account_manager_parameter_is_secret
(const McpAccountManager *mcpa,
const gchar *account,
const gchar *key);
void mcp_account_manager_parameter_make_secret
(const McpAccountManager *mcpa,
const gchar *account,
const gchar *key);
void mcp_account_manager_set_value (const McpAccountManager *mcpa,
const gchar *account,
const gchar *key,
const gchar *value);
This object represents the Telepathy AccountManager.
Most virtual methods on the McpAccountStorageIface interface receive an object provided by Mission Control that implements this interface. It can be used to manipulate Mission Control's in-memory cache of accounts.
Only Mission Control should implement this interface.
gchar * mcp_account_manager_get_unique_name (McpAccountManager *mcpa,const gchar *manager,const gchar *protocol,const GHashTable *params);
Generate and return the canonical unique name of this [new] account. Should not be called for accounts which have already had a name assigned: Intended for use when a plugin encounters an account which MC has not previously seen before (ie one created by a 3rd party in the back-end that the plugin in question provides an interface to).
|
an McpAccountManager instance |
|
the name of the manager |
|
the name of the protocol |
|
A gchar * / GValue * hash table of account parameters. |
Returns : |
the newly allocated account name, which should be freed once the caller is done with it. |
gchar * mcp_account_manager_get_value (const McpAccountManager *mcpa,const gchar *account,const gchar *key);
Fetch a copy of the current value of an account setting held by the McdAccountManager.
|
an McpAccountManager instance |
|
the unique name of an account |
|
the setting whose value we want to retrieve |
Returns : |
a gchar* which should be freed when the caller is done with it. |
GStrv mcp_account_manager_list_keys (const McpAccountManager *mcpa,const gchar *account);
gboolean mcp_account_manager_parameter_is_secret (const McpAccountManager *mcpa,const gchar *account,const gchar *key);
Determine whether a given account parameter is secret. generally this is determined by MC and passed down to us, but any McpAccountStorage plugin may decide a setting is secret, in which case the return value for this call will indicate that fact.
|
an McpAccountManager instance |
|
the unique name of an account |
|
the setting whose value we want to retrieve |
Returns : |
a gboolean, TRUE for secret settings, FALSE otherwise |
void mcp_account_manager_parameter_make_secret (const McpAccountManager *mcpa,const gchar *account,const gchar *key);
Flag an account setting as secret for the lifetime of this McpAccountManager and its corresponding McdAccountManager
|
an McpAccountManager instance |
|
the unique name of an account |
|
the setting whose value we want to retrieve |
void mcp_account_manager_set_value (const McpAccountManager *mcpa,const gchar *account,const gchar *key,const gchar *value);