Data Structures | |
struct | osso_rpc_t |
Typedefs | |
typedef gint( | osso_rpc_cb_f )(const gchar *interface, const gchar *method, GArray *arguments, gpointer data, osso_rpc_t *retval) |
typedef void( | osso_rpc_async_f )(const gchar *interface, const gchar *method, osso_rpc_t *retval, gpointer data) |
typedef void | osso_rpc_argfill (DBusMessage *msg, void *data) |
typedef void | osso_rpc_retval_free_f (osso_rpc_t *retval) |
Functions | |
void | osso_rpc_free_val (osso_rpc_t *rpc) |
osso_return_t | osso_rpc_run (osso_context_t *osso, const gchar *service, const gchar *object_path, const gchar *interface, const gchar *method, osso_rpc_t *retval, int argument_type,...) |
osso_return_t | osso_rpc_run_with_argfill (osso_context_t *osso, const gchar *service, const gchar *object_path, const gchar *interface, const gchar *method, osso_rpc_t *retval, osso_rpc_argfill *argfill, gpointer argfill_data) |
osso_return_t | osso_rpc_run_system (osso_context_t *osso, const gchar *service, const gchar *object_path, const gchar *interface, const gchar *method, osso_rpc_t *retval, int argument_type,...) |
osso_return_t | osso_rpc_run_system_with_argfill (osso_context_t *osso, const gchar *service, const gchar *object_path, const gchar *interface, const gchar *method, osso_rpc_t *retval, osso_rpc_argfill *argfill, gpointer argfill_data) |
osso_return_t | osso_rpc_run_with_defaults (osso_context_t *osso, const gchar *application, const gchar *method, osso_rpc_t *retval, int argument_type,...) |
osso_return_t | osso_rpc_async_run (osso_context_t *osso, const gchar *service, const gchar *object_path, const gchar *interface, const gchar *method, osso_rpc_async_f *async_cb, gpointer data, int argument_type,...) |
osso_return_t | osso_rpc_async_run_with_argfill (osso_context_t *osso, const gchar *service, const gchar *object_path, const gchar *interface, const gchar *method, osso_rpc_async_f *async_cb, gpointer data, osso_rpc_argfill *argfill, gpointer argfill_data) |
osso_return_t | osso_rpc_async_run_with_defaults (osso_context_t *osso, const gchar *application, const gchar *method, osso_rpc_async_f *async_cb, gpointer data, int argument_type,...) |
osso_return_t | osso_rpc_set_cb_f_with_free (osso_context_t *osso, const gchar *service, const gchar *object_path, const gchar *interface, osso_rpc_cb_f *cb, gpointer data, osso_rpc_retval_free_f *retval_free) |
osso_return_t | osso_rpc_set_cb_f (osso_context_t *osso, const gchar *service, const gchar *object_path, const gchar *interface, osso_rpc_cb_f *cb, gpointer data) |
osso_return_t | osso_rpc_set_default_cb_f_with_free (osso_context_t *osso, osso_rpc_cb_f *cb, gpointer data, osso_rpc_retval_free_f *retval_free) |
osso_return_t | osso_rpc_set_default_cb_f (osso_context_t *osso, osso_rpc_cb_f *cb, gpointer data) |
osso_return_t | osso_rpc_unset_cb_f (osso_context_t *osso, const gchar *service, const gchar *object_path, const gchar *interface, osso_rpc_cb_f *cb, gpointer data) |
osso_return_t | osso_rpc_unset_default_cb_f (osso_context_t *osso, osso_rpc_cb_f *cb, gpointer data) |
osso_return_t | osso_rpc_get_timeout (osso_context_t *osso, gint *timeout) |
osso_return_t | osso_rpc_set_timeout (osso_context_t *osso, gint timeout) |
|
This is the type of the function used with osso_rpc_run_with_argfill, osso_rpc_run_system_with_argfill, and osso_rpc_async_run_with_argfill to append the arguments to the DBUS message #msg. |
|
This is the type for the asyncronous RPC return value callback function. This function is called when the asynchronous function returns.
|
|
This is the type for the generic RPC function. This function is called every time a method is requested on the registered interface.
|
|
The type for functions that free the contents of a osso_rpc_t structure that is used as a #retval with an RPC callback. See osso_rpc_set_cb_f_with_free. |
|
This function calls an RPC function of an other application. This call is non-blocking; a callback function is registered for the return value of the called RPC function. If the application providing the service is not already running, it will be started by the D-BUS auto-activation mechanism.
|
|
This function is like osso_rpc_async_run but instead of passing the arguments for the DBUS message as a variable length argument list, you provide a function in the #argfill parameter that will provide the arguments. The #argfill function is called with the #DBusMessage object that is going to be sent and should append all arguments to that object with #dbus_message_append_args, or similar. The parameter #argfill_data will be passed to #argfill. WARNING: Using this function is not recommended, because it will make your program more dependent on the DBus API due to the appending of arguments to a DBusMessage. |
|
This function calls an RPC function for the default service of an other application. This call is non-blocking; a callback function is registered for the return value of the called RPC function. The service name of the other application is "com.nokia.A", where A is the application parameter passed to this function. Similarly, the object path is "/com/nokia/A", and the interface "com.nokia.A". If the application providing the service is not already running, it will be started by the D-BUS auto-activation mechanism.
|
|
This function frees the contents of the osso_rpc_t structure pointed to be #rpc. (It does not free the structure itself.) You need to call this for structures filled by osso_rpc_run and related functions. This function will call #g_free to free the memory pointed to by #rpc->value.s when #rpc->type is #DBUS_TYPE_STRING. This guarantee allows you to use this function as the #retval_free parameter for osso_rpc_set_cb_f, etc, when you get that string from #g_strdup, #g_strdup_printf, etc.
|
|
Sets the timeout value used by the RPC functions.
|
|
This function calls an RPC function of an other application. This call is blocking. If the application providing the function is not already running, it will be started by the D-BUS auto-activation mechanism. The variable arguments work in a type-value pairs. The type argument defines the type of the following value. If the type is G_TYPE_STRING, then the value is a pointer to a string. The list must end in a DBUS_TYPE_INVALID. The supported types are:
|
|
See osso_rpc_run. The RPC call is sent on the system bus instead |
|
|
|
This function is like osso_rpc_run but instead of passing the arguments for the DBUS message as a variable length argument list, you provide a function in the #argfill parameter that will provide the arguments. The #argfill function is called with the #DBusMessage object that is going to be sent and should append all arguments to that object with #dbus_message_append_args, or similar. The parameter #argfill_data will be passed to #argfill. WARNING: Using this function is not recommended, because it will make your program more dependent on the DBus API due to the appending of arguments to a DBusMessage. |
|
This function is a wrapper for osso_rpc_run. It calls an RPC function of an other application. This call is blocking. The service name of the other application is "com.nokia.A", where A is the application parameter passed to this function. Similarly, the object path is "/com/nokia/A", and the interface "com.nokia.A". If the application providing the service is not already running, it will be started by the D-BUS auto-activation mechanism.
|
|
Equivalent to osso_rpc_set_cb_f_with_free when passing #NULL for #retval_free. |
|
This function registers a callback function for handling RPC calls to a given object of a service.
|
|
Equivalent to osso_rpc_set_default_cb_f_with_free when passing #NULL for #retval_free. |
|
This function registers a callback function for handling RPC calls to the default service of the application. The default service is "com.nokia.A", where A is the application's name as given to osso_initialize.
|
|
Returns the current RPC timeout value.
|
|
This function unregisters an RPC callback function.
|
|
This function unregisters an RPC callback function for the default service.
|