Struct _GDBusInterfaceVTable

#[repr(C)]
pub struct _GDBusInterfaceVTable {
    pub method_call: GDBusInterfaceMethodCallFunc,
    pub get_property: GDBusInterfaceGetPropertyFunc,
    pub set_property: GDBusInterfaceSetPropertyFunc,
    pub padding: [gpointer; 8],
}

GDBusInterfaceVTable: @method_call: Function for handling incoming method calls. @get_property: Function for getting a property. @set_property: Function for setting a property.

Virtual table for handling properties and method calls for a D-Bus interface.

Since 2.38, if you want to handle getting/setting D-Bus properties asynchronously, give %NULL as your get_property() or set_property() function. The D-Bus call will be directed to your @method_call function, with the provided @interface_name set to “org.freedesktop.DBus.Properties”.

Ownership of the #GDBusMethodInvocation object passed to the method_call() function is transferred to your handler; you must call one of the methods of #GDBusMethodInvocation to return a reply (possibly empty), or an error. These functions also take ownership of the passed-in invocation object, so unless the invocation object has otherwise been referenced, it will be then be freed. Calling one of these functions may be done within your method_call() implementation but it also can be done at a later point to handle the method asynchronously.

The usual checks on the validity of the calls is performed. For Get calls, an error is automatically returned if the property does not exist or the permissions do not allow access. The same checks are performed for Set calls, and the provided value is also checked for being the correct type.

For both Get and Set calls, the #GDBusMethodInvocation passed to the @method_call handler can be queried with g_dbus_method_invocation_get_property_info() to get a pointer to the #GDBusPropertyInfo of the property.

If you have readable properties specified in your interface info, you must ensure that you either provide a non-%NULL @get_property() function or provide implementations of both the Get and GetAll methods on org.freedesktop.DBus.Properties interface in your @method_call function. Note that the required return type of the Get call is (v), not the type of the property. GetAll expects a return value of type a{sv}.

If you have writable properties specified in your interface info, you must ensure that you either provide a non-%NULL @set_property() function or provide an implementation of the Set call. If implementing the call, you must return the value of type %G_VARIANT_TYPE_UNIT.

Since: 2.26

Fields

method_call: GDBusInterfaceMethodCallFunc

get_property: GDBusInterfaceGetPropertyFunc

set_property: GDBusInterfaceSetPropertyFunc

padding: [gpointer; 8]

Trait Implementations

impl Clone for _GDBusInterfaceVTable

fn clone(&self) -> _GDBusInterfaceVTable

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for _GDBusInterfaceVTable

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for _GDBusInterfaceVTable

fn eq(&self, other: &_GDBusInterfaceVTable) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for _GDBusInterfaceVTable

impl Eq for _GDBusInterfaceVTable

impl StructuralPartialEq for _GDBusInterfaceVTable