Initialization
Detailed Description
This is the return type for the osso_initialize function.
Typedef Documentation
Function Documentation
This function closes the message bus connections and frees all memory allocated by the Libosso context. This function renders the context to unusable state. osso_initialize has to be called again to get a valid Libosso context.
- Parameters:
-
osso_context_t* osso_initialize |
( |
const gchar * |
application, |
|
|
const gchar * |
version, |
|
|
gboolean |
activation, |
|
|
GMainContext * |
context | |
|
) |
| | |
This function initializes the library, connects to both the D-BUS session and system busses, integrates with the GLib main loop, and initializes the library for use. osso_initialize should be called only once by the application.
- Parameters:
-
| application | The name of the application. This name forms the last part of the default (D-BUS) service name of the application. Note that the D-BUS service name will be 'com.nokia.application', where 'application' is the value you gave as the parameter. Note also that this argument must be identical to the X-Osso-Service value in the desktop file, or the D-BUS daemon will kill your application. If you do not want to use the default 'com.nokia' prefix, you must pass the whole D-Bus service name, e.g. 'org.maemo.my_app'. The only valid characters that the name may contain are letters a-z and the underscore '_'. |
| version | The version string of the application. It must be comparable with strcmp(). |
| activation | This parameter is obsolete and does not have any effect. |
| context | The GLib main loop context to connect to, or NULL for the default context. |
- Returns:
- A context to use in later calls to this library. NULL is returned if an error happened.