DBusGMethod

DBusGMethod — GMethod Info & Invocation

Stability Level

Stable, unless otherwise indicated

Functions

Types and Values

Includes

#include <dbus/dbus-glib.h>

Description

These types are used to call methods on GObject objects.

Functions

dbus_g_method_get_sender ()

gchar *
dbus_g_method_get_sender (DBusGMethodInvocation *context);

dbus_g_method_get_sender is deprecated and should not be used in newly-written code.

New code should use GDBus instead. The closest equivalent is g_dbus_method_invocation_get_sender().

Get the sender of a message so we can send a "reply" later (i.e. send a message directly to a service which invoked the method at a later time).

Parameters

context

the method context

 

Returns

the unique name of the sender. It is up to the caller to free the returned string.


dbus_g_method_get_reply ()

DBusMessage *
dbus_g_method_get_reply (DBusGMethodInvocation *context);

dbus_g_method_get_reply is deprecated and should not be used in newly-written code.

New code should use GDBus instead. The closest equivalent is g_dbus_method_invocation_return_value().

Get the reply message to append reply values Used as a sidedoor when you can't generate dbus values of the correct type due to glib binding limitations

Parameters

context

the method context

 

Returns

a DBusMessage with the reply


dbus_g_method_send_reply ()

void
dbus_g_method_send_reply (DBusGMethodInvocation *context,
                          DBusMessage *reply);

dbus_g_method_send_reply is deprecated and should not be used in newly-written code.

New code should use GDBus instead. The closest equivalent is g_dbus_method_invocation_return_value().

Send a manually created reply message.

Used as a sidedoor when you can't generate dbus values of the correct type due to glib binding limitations

Parameters

context

the method context

 

reply

the reply message, will be unreffed

 

dbus_g_method_return ()

void
dbus_g_method_return (DBusGMethodInvocation *context,
                      ...);

dbus_g_method_return is deprecated and should not be used in newly-written code.

New code should use GDBus instead. The closest equivalent is g_dbus_method_invocation_return_value().

Send a return message for a given method invocation, with arguments. This function also frees the sending context.

Parameters

context

the method context

 

...

zero or more values to return from the method, with their number and types given by its DBusGObjectInfo

 

dbus_g_method_return_error ()

void
dbus_g_method_return_error (DBusGMethodInvocation *context,
                            const GError *error);

dbus_g_method_return_error is deprecated and should not be used in newly-written code.

New code should use GDBus instead. The closest equivalent is g_dbus_method_invocation_return_gerror().

Send a error message for a given method invocation. This function also frees the sending context.

Parameters

context

the method context

 

error

the error to send

 

Types and Values

struct DBusGMethodInfo

struct DBusGMethodInfo {
  GCallback                 function;    
  GClosureMarshal           marshaller;  
  int                       data_offset; 
};

Object typically generated by dbus-binding-tool that stores a mapping from introspection data to a function pointer for a C method to be invoked.

Members

GCallback function;

C method to invoke

 

GClosureMarshal marshaller;

Marshaller to invoke method

 

int data_offset;

Offset into the introspection data

 

DBusGMethodInvocation

typedef struct _DBusGMethodInvocation DBusGMethodInvocation;

DBusGMethodInvocation is deprecated and should not be used in newly-written code.

New code should use GDBus instead. The closest equivalent is GDBusMethodInvocation.

The context of an asynchronous method call. See dbus_g_method_return() and dbus_g_method_return_error().

See Also

DBusGMessage