| Top |
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.
const gchar *
mm_modem_messaging_get_path (MMModemMessaging *self);
Gets the DBus path of the MMObject which implements this interface.
gchar *
mm_modem_messaging_dup_path (MMModemMessaging *self);
Gets a copy of the DBus path of the MMObject object which implements this interface.
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.
self |
A MMModem. |
|
storages |
Return location for the array of MMSmsStorage values. Do not free the returned array, it is owned by |
[out] |
n_storages |
Return location for the number of values in |
[out] |
gboolean mm_modem_messaging_get_supported_storages (MMModemMessaging *self,MMSmsStorage **storages,guint *n_storages);
Gets the list of SMS storages supported by the MMModem.
self |
A MMModem. |
|
storages |
Return location for the array of MMSmsStorage values. The returned array should be freed with |
[out][array length=n_storages] |
n_storages |
Return location for the number of values in |
[out] |
MMSmsStorage
mm_modem_messaging_get_default_storage
(MMModemMessaging *self);
Gets the default SMS storage used when storing or receiving SMS messages.
void mm_modem_messaging_create (MMModemMessaging *self,MMSmsProperties *properties,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously creates a new MMSms 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_create_finish() to get the result of the operation.
See mm_modem_messaging_create_sync() for the synchronous, blocking version of this method.
self |
||
properties |
A #MMSmsProperties object with the properties to use. |
|
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
MMSms * mm_modem_messaging_create_finish (MMModemMessaging *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_messaging_create().
self |
||
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
A newly created MMSms, or NULL if error
is set. The returned value should be freed with g_object_unref().
[transfer full]
MMSms * mm_modem_messaging_create_sync (MMModemMessaging *self,MMSmsProperties *properties,GCancellable *cancellable,GError **error);
Synchronously creates a new MMSms in the modem.
The calling thread is blocked until a reply is received. See mm_modem_messaging_create()
for the asynchronous version of this method.
self |
||
properties |
A #MMSmsProperties object with the properties to use. |
|
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
A newly created MMSms, or NULL if error
is set. The returned value should be freed with g_object_unref().
[transfer full]
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.
self |
||
sms |
Path of the MMSms to delete. |
|
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
gboolean mm_modem_messaging_delete_finish (MMModemMessaging *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_messaging_delete().
self |
||
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
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.
self |
||
sms |
Path of the MMSms to delete. |
|
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
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.
self |
||
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
GList * mm_modem_messaging_list_finish (MMModemMessaging *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_messaging_list().
self |
A MMModem. |
|
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
A list of MMSms objects, or NULL if either not found or error
is set. The returned value should be freed with g_list_free_full() using g_object_unref() as GDestroyNotify function.
[element-type ModemManager.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.
self |
||
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
A list of MMSms objects, or NULL if either not found or error
is set. The returned value should be freed with g_list_free_full() using g_object_unref() as GDestroyNotify function.
[element-type ModemManager.Sms][transfer full]
struct MMModemMessaging;
The MMModemMessaging structure contains private data and should only be accessed using the provided API.