Initialization


Typedefs

typedef osso_af_context_t osso_context_t

Functions

osso_context_tosso_initialize (const gchar *application, const gchar *version, gboolean activation, GMainContext *context)
void osso_deinitialize (osso_context_t *osso)

Detailed Description

This is the return type for the osso_initialize function.

Typedef Documentation

typedef struct osso_af_context_t osso_context_t


Function Documentation

void osso_deinitialize ( osso_context_t osso  ) 

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 The library reference as returned by osso_initialize.

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. 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.


Generated on Thu Oct 4 11:35:32 2007 for Libosso by  doxygen 1.5.1