## GMenuModel exporter

GMenuModel exporter — Export GMenuModels on D-Bus

## Synopsis

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

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

## Details

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

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

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

Since 2.32

## See Also

GMenuModel, GDBusMenuModel