| 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 : |
TRUE if storages and n_storages are set, FALSE otherwise. |
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 : |
TRUE if storages and n_storages are set, FALSE otherwise. |
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 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);
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 : |
TRUE if the sms was deleted, FALSE if error is 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 : |
TRUE if the SMS was deleted, FALSE if error is 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 error is set. The returned value should be freed with g_list_free_full() using g_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 error is set. The returned value should be freed with g_list_free_full() using g_object_unref() as GDestroyNotify function. [element-type MM.Sms][transfer full]
|