|  |  |  | libmm-glib Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Prerequisites | Known Implementations | Properties | Signals | ||||
| MmGdbusModem3gppUssdMmGdbusModem3gppUssd — Generated C code for the org.freedesktop.ModemManager1.Modem.Modem3gpp.Ussd D-Bus interface | 
MmGdbusModem3gppUssd; struct MmGdbusModem3gppUssdIface; guint mm_gdbus_modem3gpp_ussd_get_state (MmGdbusModem3gppUssd *object); const gchar * mm_gdbus_modem3gpp_ussd_get_network_request (MmGdbusModem3gppUssd *object); gchar * mm_gdbus_modem3gpp_ussd_dup_network_request (MmGdbusModem3gppUssd *object); const gchar * mm_gdbus_modem3gpp_ussd_get_network_notification (MmGdbusModem3gppUssd *object); gchar * mm_gdbus_modem3gpp_ussd_dup_network_notification (MmGdbusModem3gppUssd *object); void mm_gdbus_modem3gpp_ussd_call_initiate (MmGdbusModem3gppUssd *proxy,const gchar *arg_command,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); gboolean mm_gdbus_modem3gpp_ussd_call_initiate_finish (MmGdbusModem3gppUssd *proxy,gchar **out_reply,GAsyncResult *res,GError **error); gboolean mm_gdbus_modem3gpp_ussd_call_initiate_sync (MmGdbusModem3gppUssd *proxy,const gchar *arg_command,gchar **out_reply,GCancellable *cancellable,GError **error); void mm_gdbus_modem3gpp_ussd_call_respond (MmGdbusModem3gppUssd *proxy,const gchar *arg_response,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); gboolean mm_gdbus_modem3gpp_ussd_call_respond_finish (MmGdbusModem3gppUssd *proxy,gchar **out_reply,GAsyncResult *res,GError **error); gboolean mm_gdbus_modem3gpp_ussd_call_respond_sync (MmGdbusModem3gppUssd *proxy,const gchar *arg_response,gchar **out_reply,GCancellable *cancellable,GError **error); void mm_gdbus_modem3gpp_ussd_call_cancel (MmGdbusModem3gppUssd *proxy,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); gboolean mm_gdbus_modem3gpp_ussd_call_cancel_finish (MmGdbusModem3gppUssd *proxy,GAsyncResult *res,GError **error); gboolean mm_gdbus_modem3gpp_ussd_call_cancel_sync (MmGdbusModem3gppUssd *proxy,GCancellable *cancellable,GError **error);
MmGdbusModem3gppUssd is implemented by MMModem3gppUssd, MmGdbusModem3gppUssdProxy and MmGdbusModem3gppUssdSkeleton.
"network-notification" gchar* : Read / Write "network-request" gchar* : Read / Write "state" guint : Read / Write
This section contains code for working with the org.freedesktop.ModemManager1.Modem.Modem3gpp.Ussd D-Bus interface in C.
typedef struct _MmGdbusModem3gppUssd MmGdbusModem3gppUssd;
Abstract interface type for the D-Bus interface org.freedesktop.ModemManager1.Modem.Modem3gpp.Ussd.
struct MmGdbusModem3gppUssdIface {
  GTypeInterface parent_iface;
  gboolean (*handle_cancel) (
    MmGdbusModem3gppUssd *object,
    GDBusMethodInvocation *invocation);
  gboolean (*handle_initiate) (
    MmGdbusModem3gppUssd *object,
    GDBusMethodInvocation *invocation,
    const gchar *arg_command);
  gboolean (*handle_respond) (
    MmGdbusModem3gppUssd *object,
    GDBusMethodInvocation *invocation,
    const gchar *arg_response);
  const gchar * (*get_network_notification) (MmGdbusModem3gppUssd *object);
  const gchar * (*get_network_request) (MmGdbusModem3gppUssd *object);
  guint  (*get_state) (MmGdbusModem3gppUssd *object);
};
Virtual table for the D-Bus interface org.freedesktop.ModemManager1.Modem.Modem3gpp.Ussd.
| GTypeInterface  | The parent interface. | 
| Handler for the "handle-cancel" signal. | |
| Handler for the "handle-initiate" signal. | |
| Handler for the "handle-respond" signal. | |
| Getter for the "network-notification" property. | |
| Getter for the "network-request" property. | |
| Getter for the "state" property. | 
guint               mm_gdbus_modem3gpp_ussd_get_state   (MmGdbusModem3gppUssd *object);
Gets the value of the "State" 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 MmGdbusModem3gppUssd. | 
| Returns : | The property value. | 
const gchar *       mm_gdbus_modem3gpp_ussd_get_network_request
                                                        (MmGdbusModem3gppUssd *object);
Gets the value of the "NetworkRequest" 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_modem3gpp_ussd_dup_network_request() if on another thread.
| 
 | A MmGdbusModem3gppUssd. | 
| Returns : | The property value or NULLif the property is not set. Do not free the returned value, it belongs toobject. [transfer none] | 
gchar *             mm_gdbus_modem3gpp_ussd_dup_network_request
                                                        (MmGdbusModem3gppUssd *object);
Gets a copy of the "NetworkRequest" 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 MmGdbusModem3gppUssd. | 
| Returns : | The property value or NULLif the property is not set. The returned value should be freed withg_free(). [transfer full] | 
const gchar *       mm_gdbus_modem3gpp_ussd_get_network_notification
                                                        (MmGdbusModem3gppUssd *object);
Gets the value of the "NetworkNotification" 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_modem3gpp_ussd_dup_network_notification() if on another thread.
| 
 | A MmGdbusModem3gppUssd. | 
| Returns : | The property value or NULLif the property is not set. Do not free the returned value, it belongs toobject. [transfer none] | 
gchar *             mm_gdbus_modem3gpp_ussd_dup_network_notification
                                                        (MmGdbusModem3gppUssd *object);
Gets a copy of the "NetworkNotification" 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 MmGdbusModem3gppUssd. | 
| Returns : | The property value or NULLif the property is not set. The returned value should be freed withg_free(). [transfer full] | 
void mm_gdbus_modem3gpp_ussd_call_initiate (MmGdbusModem3gppUssd *proxy,const gchar *arg_command,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously invokes the Initiate()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_modem3gpp_ussd_call_initiate_finish() to get the result of the operation.
See mm_gdbus_modem3gpp_ussd_call_initiate_sync() for the synchronous, blocking version of this method.
| 
 | A MmGdbusModem3gppUssdProxy. | 
| 
 | 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_modem3gpp_ussd_call_initiate_finish (MmGdbusModem3gppUssd *proxy,gchar **out_reply,GAsyncResult *res,GError **error);
Finishes an operation started with mm_gdbus_modem3gpp_ussd_call_initiate().
| 
 | A MmGdbusModem3gppUssdProxy. | 
| 
 | Return location for return parameter or NULLto ignore. [out] | 
| 
 | The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_gdbus_modem3gpp_ussd_call_initiate(). | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the call succeded,FALSEiferroris set. [skip] | 
gboolean mm_gdbus_modem3gpp_ussd_call_initiate_sync (MmGdbusModem3gppUssd *proxy,const gchar *arg_command,gchar **out_reply,GCancellable *cancellable,GError **error);
Synchronously invokes the Initiate()proxy. The calling thread is blocked until a reply is received.
See mm_gdbus_modem3gpp_ussd_call_initiate() for the asynchronous version of this method.
| 
 | A MmGdbusModem3gppUssdProxy. | 
| 
 | Argument to pass with the method invocation. | 
| 
 | 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_modem3gpp_ussd_call_respond (MmGdbusModem3gppUssd *proxy,const gchar *arg_response,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously invokes the Respond()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_modem3gpp_ussd_call_respond_finish() to get the result of the operation.
See mm_gdbus_modem3gpp_ussd_call_respond_sync() for the synchronous, blocking version of this method.
| 
 | A MmGdbusModem3gppUssdProxy. | 
| 
 | 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_modem3gpp_ussd_call_respond_finish (MmGdbusModem3gppUssd *proxy,gchar **out_reply,GAsyncResult *res,GError **error);
Finishes an operation started with mm_gdbus_modem3gpp_ussd_call_respond().
| 
 | A MmGdbusModem3gppUssdProxy. | 
| 
 | Return location for return parameter or NULLto ignore. [out] | 
| 
 | The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_gdbus_modem3gpp_ussd_call_respond(). | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the call succeded,FALSEiferroris set. [skip] | 
gboolean mm_gdbus_modem3gpp_ussd_call_respond_sync (MmGdbusModem3gppUssd *proxy,const gchar *arg_response,gchar **out_reply,GCancellable *cancellable,GError **error);
Synchronously invokes the Respond()proxy. The calling thread is blocked until a reply is received.
See mm_gdbus_modem3gpp_ussd_call_respond() for the asynchronous version of this method.
| 
 | A MmGdbusModem3gppUssdProxy. | 
| 
 | Argument to pass with the method invocation. | 
| 
 | 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_modem3gpp_ussd_call_cancel (MmGdbusModem3gppUssd *proxy,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously invokes the Cancel()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_modem3gpp_ussd_call_cancel_finish() to get the result of the operation.
See mm_gdbus_modem3gpp_ussd_call_cancel_sync() for the synchronous, blocking version of this method.
| 
 | A MmGdbusModem3gppUssdProxy. | 
| 
 | 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_modem3gpp_ussd_call_cancel_finish (MmGdbusModem3gppUssd *proxy,GAsyncResult *res,GError **error);
Finishes an operation started with mm_gdbus_modem3gpp_ussd_call_cancel().
| 
 | A MmGdbusModem3gppUssdProxy. | 
| 
 | The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_gdbus_modem3gpp_ussd_call_cancel(). | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the call succeded,FALSEiferroris set. [skip] | 
gboolean mm_gdbus_modem3gpp_ussd_call_cancel_sync (MmGdbusModem3gppUssd *proxy,GCancellable *cancellable,GError **error);
Synchronously invokes the Cancel()proxy. The calling thread is blocked until a reply is received.
See mm_gdbus_modem3gpp_ussd_call_cancel() for the asynchronous version of this method.
| 
 | A MmGdbusModem3gppUssdProxy. | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the call succeded,FALSEiferroris set. [skip] | 
"network-notification" property"network-notification" gchar* : Read / Write
Represents the D-Bus property "NetworkNotification".
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: NULL
"network-request" property"network-request" gchar* : Read / Write
Represents the D-Bus property "NetworkRequest".
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: NULL
"state" property"state" guint : Read / Write
Represents the D-Bus property "State".
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
"handle-cancel" signalgboolean            user_function                      (MmGdbusModem3gppUssd  *object,
                                                        GDBusMethodInvocation *invocation,
                                                        gpointer               user_data)       : Run Last
Signal emitted when a remote caller is invoking the Cancel()
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_modem3gpp_ussd_complete_cancel() 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 MmGdbusModem3gppUssd. | 
| 
 | A GDBusMethodInvocation. | 
| 
 | user data set when the signal handler was connected. | 
| Returns : | TRUEif the invocation was handled,FALSEto let other signal handlers run. | 
"handle-initiate" signalgboolean            user_function                      (MmGdbusModem3gppUssd  *object,
                                                        GDBusMethodInvocation *invocation,
                                                        gchar                 *arg_command,
                                                        gpointer               user_data)        : Run Last
Signal emitted when a remote caller is invoking the Initiate()
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_modem3gpp_ussd_complete_initiate() 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 MmGdbusModem3gppUssd. | 
| 
 | A GDBusMethodInvocation. | 
| 
 | 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. | 
"handle-respond" signalgboolean            user_function                      (MmGdbusModem3gppUssd  *object,
                                                        GDBusMethodInvocation *invocation,
                                                        gchar                 *arg_response,
                                                        gpointer               user_data)         : Run Last
Signal emitted when a remote caller is invoking the Respond()
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_modem3gpp_ussd_complete_respond() 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 MmGdbusModem3gppUssd. | 
| 
 | A GDBusMethodInvocation. | 
| 
 | 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. |