Top | ![]() |
![]() |
![]() |
![]() |
void | (*EConfigLookupThreadFunc) () |
EConfigLookup * | e_config_lookup_new () |
ESourceRegistry * | e_config_lookup_get_registry () |
ESource * | e_config_lookup_get_source () |
void | e_config_lookup_run () |
void | e_config_lookup_run_finish () |
void | e_config_lookup_create_thread () |
void | e_config_lookup_add_result () |
GSList * | e_config_lookup_get_results () |
#define | E_CONFIG_LOOKUP_PARAM_USER |
#define | E_CONFIG_LOOKUP_PARAM_PASSWORD |
#define | E_CONFIG_LOOKUP_PARAM_EMAIL_ADDRESS |
#define | E_CONFIG_LOOKUP_PARAM_SERVERS |
struct | EConfigLookup |
EConfigLookup is used to search for configuration of an account, which is identified by an e-mail address, server address or such. It is an EExtensible object, where the extensions connect to the “run” signal to run the configuration lookup.
void (*EConfigLookupThreadFunc) (EConfigLookup *config_lookup
,const ENamedParameters *params
,gpointer user_data
,GCancellable *cancellable
);
EConfigLookupThreadFunc
is deprecated and should not be used in newly-written code.
A function executed in a dedicated thread.
config_lookup |
||
params |
an ENamedParameters with additional parameters |
|
user_data |
user data passed to |
|
cancellable |
a GCancellable |
Since: 3.26
EConfigLookup *
e_config_lookup_new (ESourceRegistry *registry
);
e_config_lookup_new
is deprecated and should not be used in newly-written code.
Creates a new EConfigLookup instance.
Since: 3.26
ESourceRegistry *
e_config_lookup_get_registry (EConfigLookup *config_lookup
);
e_config_lookup_get_registry
is deprecated and should not be used in newly-written code.
Returns the ESourceRegistry passed to e_config_lookup_new()
.
Since: 3.26
ESource * e_config_lookup_get_source (EConfigLookup *config_lookup
,EConfigLookupSourceKind kind
);
e_config_lookup_get_source
is deprecated and should not be used in newly-written code.
Emits the “get-source” signal and any listener can provide
the source. The function can return NULL
, when there are no listeners
or when such source is not available.
config_lookup |
||
kind |
one of EConfigLookupSourceKind, except of the |
Since: 3.26
void e_config_lookup_run (EConfigLookup *config_lookup
,const ENamedParameters *params
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
e_config_lookup_run
is deprecated and should not be used in newly-written code.
Runs configuration lookup asynchronously, by emitting the “run” signal.
Once the run is done, the callback
is called, and the call can be finished with
e_config_lookup_run_finish()
. The callback
is always called from the main thread.
Note that there cannot be run two lookups at the same time, thus if it
happens, then the callback
is called immediately with a NULL
result.
config_lookup |
||
params |
an ENamedParameters with lookup parameters |
|
cancellable |
an optional GCancellable, or |
|
callback |
a callback to call, when the run is finished |
|
user_data |
user data for the |
Since: 3.26
void e_config_lookup_run_finish (EConfigLookup *config_lookup
,GAsyncResult *result
);
e_config_lookup_run_finish
is deprecated and should not be used in newly-written code.
Finishes the configuration lookup previously run by e_config_lookup_run()
.
It's expected that the extensions may fail, thus it doesn't return
anything and is provided mainly for consistency with asynchronous API.
Since: 3.26
void e_config_lookup_create_thread (EConfigLookup *config_lookup
,const ENamedParameters *params
,EActivity *activity
,EConfigLookupThreadFunc thread_func
,gpointer user_data
,GDestroyNotify user_data_free
);
e_config_lookup_create_thread
is deprecated and should not be used in newly-written code.
Creates a new thread and calls thread_func
in it. It also references activity
and unreferences it once the thread_func
is done.
This function might be usually called by extensions in a signal handler for the “run” signal.
config_lookup |
||
params |
an ENamedParameters with lookup parameters |
|
activity |
an EActivity |
|
thread_func |
function to call in a new thread |
|
user_data |
optional user data for |
[nullable] |
user_data_free |
optional free function for |
[nullable] |
Since: 3.26
void e_config_lookup_add_result (EConfigLookup *config_lookup
,EConfigLookupResult *result
);
e_config_lookup_add_result
is deprecated and should not be used in newly-written code.
Adds a new result
in a list of known configuration lookup results.
The config_lookup
assumes ownership of the result
and frees it
when no longer needed.
The list of results can be obtained with e_config_lookup_get_results()
.
Since: 3.26
GSList * e_config_lookup_get_results (EConfigLookup *config_lookup
,EConfigLookupResultKind kind
,const gchar *protocol
);
e_config_lookup_get_results
is deprecated and should not be used in newly-written code.
Returns a GSList with EConfigLookupResult objects satisfying
the kind
and protocol
filtering conditions. To receive all
gathered results use E_CONFIG_LOOKUP_RESULT_UNKNOWN
for kind
and NULL
for the protocol
.
Free the returned GSList with g_slist_free_full (results, g_object_unref); when no longer needed.
config_lookup |
||
kind |
an EConfigLookupResultKind to filter the results with |
|
protocol |
optional protocol to filter the results with, or |
[nullable] |
a GSList
with results satisfying the kind
and protocol
filtering conditions.
[element-type EConfigLookupResult][transfer full]
Since: 3.26
#define E_CONFIG_LOOKUP_PARAM_USER "user"
E_CONFIG_LOOKUP_PARAM_USER
is deprecated and should not be used in newly-written code.
#define E_CONFIG_LOOKUP_PARAM_PASSWORD "password"
E_CONFIG_LOOKUP_PARAM_PASSWORD
is deprecated and should not be used in newly-written code.
#define E_CONFIG_LOOKUP_PARAM_EMAIL_ADDRESS "email-address"
E_CONFIG_LOOKUP_PARAM_EMAIL_ADDRESS
is deprecated and should not be used in newly-written code.
#define E_CONFIG_LOOKUP_PARAM_SERVERS "servers"
E_CONFIG_LOOKUP_PARAM_SERVERS
is deprecated and should not be used in newly-written code.
struct EConfigLookup { };
EConfigLookup
is deprecated and should not be used in newly-written code.
Contains only private data that should be read and manipulated using the functions below.
Since: 3.26