|  |  |  | libmm-glib Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | ||||
struct MMModemMessaging; const gchar * mm_modem_messaging_get_path (MMModemMessaging *self); gchar * mm_modem_messaging_dup_path (MMModemMessaging *self); gboolean mm_modem_messaging_peek_supported_storages (MMModemMessaging *self,const MMSmsStorage **storages,guint *n_storages); gboolean mm_modem_messaging_get_supported_storages (MMModemMessaging *self,MMSmsStorage **storages,guint *n_storages); MMSmsStorage mm_modem_messaging_get_default_storage (MMModemMessaging *self); void mm_modem_messaging_create (MMModemMessaging *self,MMSmsProperties *properties,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); MMSms * mm_modem_messaging_create_finish (MMModemMessaging *self,GAsyncResult *res,GError **error); MMSms * mm_modem_messaging_create_sync (MMModemMessaging *self,MMSmsProperties *properties,GCancellable *cancellable,GError **error); void mm_modem_messaging_delete (MMModemMessaging *self,const gchar *sms,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); gboolean mm_modem_messaging_delete_finish (MMModemMessaging *self,GAsyncResult *res,GError **error); gboolean mm_modem_messaging_delete_sync (MMModemMessaging *self,const gchar *sms,GCancellable *cancellable,GError **error); void mm_modem_messaging_list (MMModemMessaging *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); GList * mm_modem_messaging_list_finish (MMModemMessaging *self,GAsyncResult *res,GError **error); GList * mm_modem_messaging_list_sync (MMModemMessaging *self,GCancellable *cancellable,GError **error);
MMModemMessaging implements GDBusInterface, GInitable, GAsyncInitable and MmGdbusModemMessaging.
The MMModemMessaging is an object providing access to the methods, signals and properties of the Messaging interface.
The Messaging interface is exposed whenever a modem has messaging capabilities.
struct MMModemMessaging;
The MMModemMessaging structure contains private data and should only be accessed using the provided API.
const gchar *       mm_modem_messaging_get_path         (MMModemMessaging *self);
Gets the DBus path of the MMObject which implements this interface.
| 
 | A MMModemMessaging. | 
| Returns : | The DBus path of the MMObject object. [transfer none] | 
gchar *             mm_modem_messaging_dup_path         (MMModemMessaging *self);
Gets a copy of the DBus path of the MMObject object which implements this interface.
| 
 | A MMModemMessaging. | 
| Returns : | The DBus path of the MMObject. The returned value should be freed with g_free(). [transfer full] | 
gboolean mm_modem_messaging_peek_supported_storages (MMModemMessaging *self,const MMSmsStorage **storages,guint *n_storages);
Gets the list of SMS storages supported by the MMModem.
| 
 | A MMModem. | 
| 
 | Return location for the array of MMSmsStorage values. Do not free the returned array, it is owned by self. [out] | 
| 
 | Return location for the number of values in storages. [out] | 
| Returns : | TRUEifstoragesandn_storagesare set,FALSEotherwise. | 
gboolean mm_modem_messaging_get_supported_storages (MMModemMessaging *self,MMSmsStorage **storages,guint *n_storages);
Gets the list of SMS storages supported by the MMModem.
| 
 | A MMModem. | 
| 
 | Return location for the array of MMSmsStorage values. The returned array should be freed with g_free()when no longer needed. [out][array length=n_storages] | 
| 
 | Return location for the number of values in storages. [out] | 
| Returns : | TRUEifstoragesandn_storagesare set,FALSEotherwise. | 
MMSmsStorage        mm_modem_messaging_get_default_storage
                                                        (MMModemMessaging *self);
Gets the default SMS storage used when storing or receiving SMS messages.
| 
 | A MMModem. | 
| Returns : | the default MMSmsStorage. | 
void mm_modem_messaging_create (MMModemMessaging *self,MMSmsProperties *properties,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
MMSms * mm_modem_messaging_create_finish (MMModemMessaging *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_messaging_create().
| 
 | A MMModemMessaging. | 
| 
 | The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_modem_messaging_create(). | 
| 
 | Return location for error or NULL. | 
| Returns : | A newly created MMSms, or NULLiferroris set. The returned value should be freed withg_object_unref(). [transfer full] | 
MMSms * mm_modem_messaging_create_sync (MMModemMessaging *self,MMSmsProperties *properties,GCancellable *cancellable,GError **error);
void mm_modem_messaging_delete (MMModemMessaging *self,const gchar *sms,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously deletes a given MMSms from the modem.
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_modem_messaging_delete_finish() to get the result of the operation.
See mm_modem_messaging_delete_sync() for the synchronous, blocking version of this method.
| 
 | A MMModemMessaging. | 
| 
 | Path of the MMSms to delete. | 
| 
 | 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_modem_messaging_delete_finish (MMModemMessaging *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_messaging_delete().
| 
 | A MMModemMessaging. | 
| 
 | The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_modem_messaging_delete(). | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the sms was deleted,FALSEiferroris set. | 
gboolean mm_modem_messaging_delete_sync (MMModemMessaging *self,const gchar *sms,GCancellable *cancellable,GError **error);
Synchronously deletes a given MMSms from the modem.
The calling thread is blocked until a reply is received. See mm_modem_messaging_delete()
for the asynchronous version of this method.
| 
 | A MMModemMessaging. | 
| 
 | Path of the MMSms to delete. | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the SMS was deleted,FALSEiferroris set. | 
void mm_modem_messaging_list (MMModemMessaging *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously lists the MMSms objects in the modem.
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_modem_messaging_list_finish() to get the result of the operation.
See mm_modem_messaging_list_sync() for the synchronous, blocking version of this method.
| 
 | A MMModemMessaging. | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | A GAsyncReadyCallback to call when the request is satisfied or NULL. | 
| 
 | User data to pass to callback. | 
GList * mm_modem_messaging_list_finish (MMModemMessaging *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_messaging_list().
| 
 | A MMModem. | 
| 
 | The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_modem_messaging_list(). | 
| 
 | Return location for error or NULL. | 
| Returns : | A list of MMSms objects, or NULL if either not found or erroris set. The returned value should be freed withg_list_free_full()usingg_object_unref()as GDestroyNotify function. [element-type MM.Sms][transfer full] | 
GList * mm_modem_messaging_list_sync (MMModemMessaging *self,GCancellable *cancellable,GError **error);
Synchronously lists the MMSms objects in the modem.
The calling thread is blocked until a reply is received. See mm_modem_messaging_list()
for the asynchronous version of this method.
| 
 | A MMModemMessaging. | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | Return location for error or NULL. | 
| Returns : | A list of MMSms objects, or NULL if either not found or erroris set. The returned value should be freed withg_list_free_full()usingg_object_unref()as GDestroyNotify function. [element-type MM.Sms][transfer full] |