GIO Reference Manual: GMenuModel exporter

## GMenuModel exporter GMenuModel exporter — Export GMenuModels on D-Bus |

## Functions

guint | g_dbus_connection_export_menu_model ()
void | g_dbus_connection_unexport_menu_model ()

## Includes

    #include <gio/gio.h>

## Description

These functions support exporting a GMenuModel on D-Bus. The D-Bus interface that is used is a private implementation detail.

To access an exported GMenuModel remotely, use `g_dbus_menu_model_get()` to obtain a GDBusMenuModel.

## Functions

### g_dbus_connection_export_menu_model ()

    guint
    g_dbus_connection_export_menu_model (GDBusConnection *connection,
                                         const gchar *object_path,
                                         GMenuModel *menu,
                                         GError **error);

Exports `menu` on `connection` at `object_path` .

The implemented D-Bus API should be considered private. It is subject to change in the future.

An object path can only have one menu model exported on it. If this constraint is violated, the export will fail and 0 will be returned (with `error` set accordingly).

You can unexport the menu model using `g_dbus_connection_unexport_menu_model()` with the return value of this function.

#### Parameters

connection | a GDBusConnection |
object_path | a D-Bus object path |
menu | a GMenuModel |
error | return location for an error, or `NULL` |

#### Returns

the ID of the export (never zero), or 0 in case of failure

Since 2.32

### g_dbus_connection_unexport_menu_model ()

    void
    g_dbus_connection_unexport_menu_model (GDBusConnection *connection,
                                           guint export_id);

Reverses the effect of a previous call to `g_dbus_connection_export_menu_model()`.

It is an error to call this function with an ID that wasn't returned from `g_dbus_connection_export_menu_model()` or to call it with the same ID more than once.

#### Parameters

connection | a GDBusConnection |
export_id | the ID from `g_dbus_connection_export_menu_model()` |

Since 2.32

## Types and Values

## See Also

GMenuModel, GDBusMenuModel