|  |  |  | libmm-glib Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Prerequisites | Known Implementations | Properties | Signals | ||||
| MmGdbusModemLocationMmGdbusModemLocation — Generated C code for the org.freedesktop.ModemManager1.Modem.Location D-Bus interface | 
MmGdbusModemLocation; struct MmGdbusModemLocationIface; guint mm_gdbus_modem_location_get_enabled (MmGdbusModemLocation *object); guint mm_gdbus_modem_location_get_capabilities (MmGdbusModemLocation *object); gboolean mm_gdbus_modem_location_get_signals_location (MmGdbusModemLocation *object); GVariant * mm_gdbus_modem_location_get_location (MmGdbusModemLocation *object); GVariant * mm_gdbus_modem_location_dup_location (MmGdbusModemLocation *object); void mm_gdbus_modem_location_call_get_location (MmGdbusModemLocation *proxy,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); gboolean mm_gdbus_modem_location_call_get_location_finish (MmGdbusModemLocation *proxy,GVariant **out_Location,GAsyncResult *res,GError **error); gboolean mm_gdbus_modem_location_call_get_location_sync (MmGdbusModemLocation *proxy,GVariant **out_Location,GCancellable *cancellable,GError **error); void mm_gdbus_modem_location_call_setup (MmGdbusModemLocation *proxy,guint arg_sources,gboolean arg_signal_location,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); gboolean mm_gdbus_modem_location_call_setup_finish (MmGdbusModemLocation *proxy,GAsyncResult *res,GError **error); gboolean mm_gdbus_modem_location_call_setup_sync (MmGdbusModemLocation *proxy,guint arg_sources,gboolean arg_signal_location,GCancellable *cancellable,GError **error);
MmGdbusModemLocation is implemented by MMModemLocation, MmGdbusModemLocationProxy and MmGdbusModemLocationSkeleton.
"capabilities" guint : Read / Write "enabled" guint : Read / Write "location" GVariant* : Read / Write "signals-location" gboolean : Read / Write
This section contains code for working with the org.freedesktop.ModemManager1.Modem.Location D-Bus interface in C.
typedef struct _MmGdbusModemLocation MmGdbusModemLocation;
Abstract interface type for the D-Bus interface org.freedesktop.ModemManager1.Modem.Location.
struct MmGdbusModemLocationIface {
  GTypeInterface parent_iface;
  gboolean (*handle_get_location) (
    MmGdbusModemLocation *object,
    GDBusMethodInvocation *invocation);
  gboolean (*handle_setup) (
    MmGdbusModemLocation *object,
    GDBusMethodInvocation *invocation,
    guint arg_sources,
    gboolean arg_signal_location);
  guint  (*get_capabilities) (MmGdbusModemLocation *object);
  guint  (*get_enabled) (MmGdbusModemLocation *object);
  GVariant * (*get_location) (MmGdbusModemLocation *object);
  gboolean  (*get_signals_location) (MmGdbusModemLocation *object);
};
Virtual table for the D-Bus interface org.freedesktop.ModemManager1.Modem.Location.
| GTypeInterface  | The parent interface. | 
| Handler for the "handle-get-location" signal. | |
| Handler for the "handle-setup" signal. | |
| Getter for the "capabilities" property. | |
| Getter for the "enabled" property. | |
| Getter for the "location" property. | |
| Getter for the "signals-location" property. | 
guint               mm_gdbus_modem_location_get_enabled (MmGdbusModemLocation *object);
Gets the value of the "Enabled" D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
| 
 | A MmGdbusModemLocation. | 
| Returns : | The property value. | 
guint               mm_gdbus_modem_location_get_capabilities
                                                        (MmGdbusModemLocation *object);
Gets the value of the "Capabilities" D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
| 
 | A MmGdbusModemLocation. | 
| Returns : | The property value. | 
gboolean            mm_gdbus_modem_location_get_signals_location
                                                        (MmGdbusModemLocation *object);
Gets the value of the "SignalsLocation" D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
| 
 | A MmGdbusModemLocation. | 
| Returns : | The property value. | 
GVariant *          mm_gdbus_modem_location_get_location
                                                        (MmGdbusModemLocation *object);
Gets the value of the "Location" D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
object was constructed. Use mm_gdbus_modem_location_dup_location() if on another thread.
| 
 | A MmGdbusModemLocation. | 
| Returns : | The property value or NULLif the property is not set. Do not free the returned value, it belongs toobject. [transfer none] | 
GVariant *          mm_gdbus_modem_location_dup_location
                                                        (MmGdbusModemLocation *object);
Gets a copy of the "Location" D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
| 
 | A MmGdbusModemLocation. | 
| Returns : | The property value or NULLif the property is not set. The returned value should be freed withg_variant_unref(). [transfer full] | 
void mm_gdbus_modem_location_call_get_location (MmGdbusModemLocation *proxy,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously invokes the GetLocation()proxy.
When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_gdbus_modem_location_call_get_location_finish() to get the result of the operation.
See mm_gdbus_modem_location_call_get_location_sync() for the synchronous, blocking version of this method.
| 
 | A MmGdbusModemLocationProxy. | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | A GAsyncReadyCallback to call when the request is satisfied or NULL. | 
| 
 | User data to pass to callback. | 
gboolean mm_gdbus_modem_location_call_get_location_finish (MmGdbusModemLocation *proxy,GVariant **out_Location,GAsyncResult *res,GError **error);
Finishes an operation started with mm_gdbus_modem_location_call_get_location().
| 
 | A MmGdbusModemLocationProxy. | 
| 
 | Return location for return parameter or NULLto ignore. [out] | 
| 
 | The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_gdbus_modem_location_call_get_location(). | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the call succeded,FALSEiferroris set. [skip] | 
gboolean mm_gdbus_modem_location_call_get_location_sync (MmGdbusModemLocation *proxy,GVariant **out_Location,GCancellable *cancellable,GError **error);
Synchronously invokes the GetLocation()proxy. The calling thread is blocked until a reply is received.
See mm_gdbus_modem_location_call_get_location() for the asynchronous version of this method.
| 
 | A MmGdbusModemLocationProxy. | 
| 
 | Return location for return parameter or NULLto ignore. [out] | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the call succeded,FALSEiferroris set. [skip] | 
void mm_gdbus_modem_location_call_setup (MmGdbusModemLocation *proxy,guint arg_sources,gboolean arg_signal_location,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously invokes the Setup()proxy.
When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_gdbus_modem_location_call_setup_finish() to get the result of the operation.
See mm_gdbus_modem_location_call_setup_sync() for the synchronous, blocking version of this method.
| 
 | A MmGdbusModemLocationProxy. | 
| 
 | Argument to pass with the method invocation. | 
| 
 | Argument to pass with the method invocation. | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | A GAsyncReadyCallback to call when the request is satisfied or NULL. | 
| 
 | User data to pass to callback. | 
gboolean mm_gdbus_modem_location_call_setup_finish (MmGdbusModemLocation *proxy,GAsyncResult *res,GError **error);
Finishes an operation started with mm_gdbus_modem_location_call_setup().
| 
 | A MmGdbusModemLocationProxy. | 
| 
 | The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_gdbus_modem_location_call_setup(). | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the call succeded,FALSEiferroris set. [skip] | 
gboolean mm_gdbus_modem_location_call_setup_sync (MmGdbusModemLocation *proxy,guint arg_sources,gboolean arg_signal_location,GCancellable *cancellable,GError **error);
Synchronously invokes the Setup()proxy. The calling thread is blocked until a reply is received.
See mm_gdbus_modem_location_call_setup() for the asynchronous version of this method.
| 
 | A MmGdbusModemLocationProxy. | 
| 
 | Argument to pass with the method invocation. | 
| 
 | Argument to pass with the method invocation. | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the call succeded,FALSEiferroris set. [skip] | 
"capabilities" property"capabilities" guint : Read / Write
Represents the D-Bus property "Capabilities".
Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Default value: 0
"enabled" property"enabled" guint : Read / Write
Represents the D-Bus property "Enabled".
Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Default value: 0
"location" property"location" GVariant* : Read / Write
Represents the D-Bus property "Location".
Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Allowed values: GVariant<a{uv}>
Default value: NULL
"signals-location" property"signals-location" gboolean : Read / Write
Represents the D-Bus property "SignalsLocation".
Since the D-Bus property for this GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Default value: FALSE
"handle-get-location" signalgboolean            user_function                      (MmGdbusModemLocation  *object,
                                                        GDBusMethodInvocation *invocation,
                                                        gpointer               user_data)       : Run Last
Signal emitted when a remote caller is invoking the GetLocation()
If a signal handler returns TRUE, it means the signal handler will handle the invocation (e.g. take a reference to invocation and eventually call mm_gdbus_modem_location_complete_get_location() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
| 
 | A MmGdbusModemLocation. | 
| 
 | A GDBusMethodInvocation. | 
| 
 | user data set when the signal handler was connected. | 
| Returns : | TRUEif the invocation was handled,FALSEto let other signal handlers run. | 
"handle-setup" signalgboolean            user_function                      (MmGdbusModemLocation  *object,
                                                        GDBusMethodInvocation *invocation,
                                                        guint                  arg_sources,
                                                        gboolean               arg_signal_location,
                                                        gpointer               user_data)                : Run Last
Signal emitted when a remote caller is invoking the Setup()
If a signal handler returns TRUE, it means the signal handler will handle the invocation (e.g. take a reference to invocation and eventually call mm_gdbus_modem_location_complete_setup() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
| 
 | A MmGdbusModemLocation. | 
| 
 | A GDBusMethodInvocation. | 
| 
 | Argument passed by remote caller. | 
| 
 | Argument passed by remote caller. | 
| 
 | user data set when the signal handler was connected. | 
| Returns : | TRUEif the invocation was handled,FALSEto let other signal handlers run. |