MMObject

## MMObject MMObject — Generic object representing a modem in ModemManager |

## Synopsis

    struct              MMObject;

    const gchar *       mm_object_get_path                  (MMObject *self);
    gchar *             mm_object_dup_path                  (MMObject *self);

    MMModem *           mm_object_peek_modem                (MMObject *self);
    MMModem *           mm_object_get_modem                 (MMObject *self);
    MMModem3gpp *       mm_object_peek_modem_3gpp           (MMObject *self);
    MMModem3gpp *       mm_object_get_modem_3gpp            (MMObject *self);
    MMModem3gppUssd *   mm_object_peek_modem_3gpp_ussd      (MMObject *self);
    MMModem3gppUssd *   mm_object_get_modem_3gpp_ussd       (MMObject *self);
    MMModemCdma *       mm_object_peek_modem_cdma           (MMObject *self);
    MMModemCdma *       mm_object_get_modem_cdma            (MMObject *self);
    MMModemLocation *   mm_object_peek_modem_location       (MMObject *self);
    MMModemLocation *   mm_object_get_modem_location        (MMObject *self);
    MMModemMessaging *  mm_object_peek_modem_messaging      (MMObject *self);
    MMModemMessaging *  mm_object_get_modem_messaging       (MMObject *self);
    MMModemTime *       mm_object_peek_modem_time           (MMObject *self);
    MMModemTime *       mm_object_get_modem_time            (MMObject *self);
    MMModemFirmware *   mm_object_peek_modem_firmware       (MMObject *self);
    MMModemFirmware *   mm_object_get_modem_firmware        (MMObject *self);
    MMModemSimple *     mm_object_peek_modem_simple         (MMObject *self);
    MMModemSimple *     mm_object_get_modem_simple          (MMObject *self);

## Object Hierarchy

      GObject
       +----GDBusObjectProxy
             +----MmGdbusObjectProxy
                   +----MMObject

## Implemented Interfaces

MMObject implements GDBusObject and MmGdbusObject.

## Description

The MMObject is a generic object which represents any kind of modem exposed in ModemManager, and allows accessing the exported interfaces one by one.

When this object is available, it is ensured that at least the Modem interface is also available.

## Details

### struct MMObject

    struct MMObject;

The MMObject structure contains private data and should only be accessed using the provided API.

### mm_object_get_path ()

    const gchar *       mm_object_get_path                  (MMObject *self);

Gets the DBus path of the MMObject object.

`self` : | A MMObject.
Returns : | The DBus path of the MMObject object. [transfer none]

### mm_object_dup_path ()

    gchar *             mm_object_dup_path                  (MMObject *self);

Gets a copy of the DBus path of the MMObject object.

`self` : | A MMObject.
Returns : | The DBus path of the MMObject. The returned value should be freed with `g_free()`. [transfer full]

### mm_object_peek_modem ()

    MMModem *           mm_object_peek_modem                (MMObject *self);

Like `mm_object_get_modem()` but doesn't increase the reference count on the returned object.

### Warning

It is not safe to use the returned object if you are on another thread than the one where the MMManager is running.

`self` : | A MMObject.
Returns : | A MMModem or `NULL` if `self` does not implement the interface. Do not free the returned object, it is owned by `self`. [transfer none]

### mm_object_get_modem ()

    MMModem *           mm_object_get_modem                 (MMObject *self);

Gets the MMModem instance for the D-Bus interface org.freedesktop.ModemManager1.Modem on `self`, if any.

`self` : | A MMModem
Returns : | A MMModem that must be freed with `g_object_unref()` or `NULL` if `self` does not implement the interface. [transfer full]

### mm_object_peek_modem_3gpp ()

    MMModem3gpp *       mm_object_peek_modem_3gpp           (MMObject *self);

Like `mm_object_get_modem_3gpp()` but doesn't increase the reference count on the returned object.

### Warning

It is not safe to use the returned object if you are on another thread than the one where the MMManager is running.

`self` : | A MMObject.
Returns : | A MMModem3gpp or `NULL` if `self` does not implement the interface. Do not free the returned object, it is owned by `self`. [transfer none]

### mm_object_get_modem_3gpp ()

    MMModem3gpp *       mm_object_get_modem_3gpp            (MMObject *self);

Gets the MMModem3gpp instance for the D-Bus interface org.freedesktop.ModemManager1.Modem.Modem3gpp on `self`, if any.

`self` : | A MMObject.
Returns : | A MMModem3gpp that must be freed with `g_object_unref()` or `NULL` if `self` does not implement the interface. [transfer full]

### mm_object_peek_modem_3gpp_ussd ()

    MMModem3gppUssd *   mm_object_peek_modem_3gpp_ussd      (MMObject *self);

Like `mm_object_get_modem_3gpp_ussd()` but doesn't increase the reference count on the returned object.

### Warning

It is not safe to use the returned object if you are on another thread than the one where the MMManager is running.

`self` : | A MMObject.
Returns : | A MMModem3gppUssd or `NULL` if `self` does not implement the interface. Do not free the returned object, it is owned by `self`. [transfer none]

### mm_object_get_modem_3gpp_ussd ()

    MMModem3gppUssd *   mm_object_get_modem_3gpp_ussd       (MMObject *self);

Gets the MMModem3gppUssd instance for the D-Bus interface org.freedesktop.ModemManager1.Modem.Modem3gpp-Ussd on `self`, if any.

`self` : | A MMObject.
Returns : | A MMModem3gppUssd that must be freed with `g_object_unref()` or `NULL` if `self` does not implement the interface. [transfer full]

### mm_object_peek_modem_cdma ()

    MMModemCdma *       mm_object_peek_modem_cdma           (MMObject *self);

Like `mm_object_get_modem_cdma()` but doesn't increase the reference count on the returned object.

### Warning

It is not safe to use the returned object if you are on another thread than the one where the MMManager is running.

`self` : | A MMObject.
Returns : | A MMModemCdma or `NULL` if `self` does not implement the interface. Do not free the returned object, it is owned by `self`. [transfer none]

### mm_object_get_modem_cdma ()

    MMModemCdma *       mm_object_get_modem_cdma            (MMObject *self);

Gets the MMModemCdma instance for the D-Bus interface org.freedesktop.ModemManager1.Modem.ModemCdma on `self`, if any.

`self` : | A MMObject.
Returns : | A MMModemCdma that must be freed with `g_object_unref()` or `NULL` if `self` does not implement the interface. [transfer full]

### mm_object_peek_modem_location ()

    MMModemLocation *   mm_object_peek_modem_location       (MMObject *self);

Like `mm_object_get_modem_location()` but doesn't increase the reference count on the returned object.

### Warning

It is not safe to use the returned object if you are on another thread than the one where the MMManager is running.

`self` : | A MMObject.
Returns : | A MMModemLocation or `NULL` if `self` does not implement the interface. Do not free the returned object, it is owned by `self`. [transfer none]

### mm_object_get_modem_location ()

    MMModemLocation *   mm_object_get_modem_location        (MMObject *self);

Gets the MMModemLocation instance for the D-Bus interface org.freedesktop.ModemManager1.Modem.Modemlocation on `self`, if any.

`self` : | A MMObject.
Returns : | A MMModemLocation that must be freed with `g_object_unref()` or `NULL` if `self` does not implement the interface. [transfer full]

### mm_object_peek_modem_messaging ()

    MMModemMessaging *  mm_object_peek_modem_messaging      (MMObject *self);

Like `mm_object_get_modem_messaging()` but doesn't increase the reference count on the returned object.

### Warning

It is not safe to use the returned object if you are on another thread than the one where the MMManager is running.

`self` : | A MMObject.
Returns : | A MMModemMessaging or `NULL` if `self` does not implement the interface. Do not free the returned object, it is owned by `self`. [transfer none]

### mm_object_get_modem_messaging ()

    MMModemMessaging *  mm_object_get_modem_messaging       (MMObject *self);

Gets the MMModemMessaging instance for the D-Bus interface org.freedesktop.ModemManager1.Modem.Modemmessaging on `self`, if any.

`self` : | A MMObject.
Returns : | A MMModemMessaging that must be freed with `g_object_unref()` or `NULL` if `self` does not implement the interface. [transfer full]

### mm_object_peek_modem_time ()

    MMModemTime *       mm_object_peek_modem_time           (MMObject *self);

Like `mm_object_get_modem_time()` but doesn't increase the reference count on the returned object.

### Warning

It is not safe to use the returned object if you are on another thread than the one where the MMManager is running.

`self` : | A MMObject.
Returns : | A MMModemTime or `NULL` if `self` does not implement the interface. Do not free the returned object, it is owned by `self`. [transfer none]

### mm_object_get_modem_time ()

    MMModemTime *       mm_object_get_modem_time            (MMObject *self);

Gets the MMModemTime instance for the D-Bus interface org.freedesktop.ModemManager1.Modem.Time on `self`, if any.

`self` : | A MMObject.
Returns : | A MMModemTime that must be freed with `g_object_unref()` or `NULL` if `self` does not implement the interface. [transfer full]

### mm_object_peek_modem_firmware ()

    MMModemFirmware *   mm_object_peek_modem_firmware       (MMObject *self);

Like `mm_object_get_modem_firmware()` but doesn't increase the reference count on the returned object.

### Warning

It is not safe to use the returned object if you are on another thread than the one where the MMManager is running.

`self` : | A MMObject.
Returns : | A MMModemFirmware or `NULL` if `self` does not implement the interface. Do not free the returned object, it is owned by `self`. [transfer none]

### mm_object_get_modem_firmware ()

    MMModemFirmware *   mm_object_get_modem_firmware        (MMObject *self);

Gets the MMModemFirmware instance for the D-Bus interface org.freedesktop.ModemManager1.Modem.Firmware on `self`, if any.

`self` : | A MMObject.
Returns : | A MMModemFirmware that must be freed with `g_object_unref()` or `NULL` if `self` does not implement the interface. [transfer full]

### mm_object_peek_modem_simple ()

    MMModemSimple *     mm_object_peek_modem_simple         (MMObject *self);

Like `mm_object_get_modem_simple()` but doesn't increase the reference count on the returned object.

### Warning

It is not safe to use the returned object if you are on another thread than the one where the MMManager is running.

`self` : | A MMObject.
Returns : | A MMModemSimple or `NULL` if `self` does not implement the interface. Do not free the returned object, it is owned by `self`. [transfer none]

### mm_object_get_modem_simple ()

    MMModemSimple *     mm_object_get_modem_simple          (MMObject *self);

Gets the MMModemSimple instance for the D-Bus interface org.freedesktop.ModemManager1.Modem.Modemsimple on `self`, if any.

`self` : | A MMObject.
Returns : | A MMModemSimple that must be freed with `g_object_unref()` or `NULL` if `self` does not implement the interface. [transfer full]