ModemManager.ModemMessaging¶

Subclasses:: None

Methods¶

Inherited:: ModemManager.GdbusModemMessagingProxy (6), Gio.DBusProxy (25), GObject.Object (37), Gio.AsyncInitable (4), Gio.DBusInterface (3), Gio.Initable (2), ModemManager.GdbusModemMessaging (20)
Structs:: GObject.ObjectClass (5)

	`create` (properties, cancellable, callback, *user_data)
	`create_finish` (res)
	`create_sync` (properties, cancellable)
	`delete` (sms, cancellable, callback, *user_data)
	`delete_finish` (res)
	`delete_sync` (sms, cancellable)
	`dup_path` ()
	`get_default_storage` ()
	`get_path` ()
	`get_supported_storages` ()
	`list` (cancellable, callback, *user_data)
	`list_finish` (res)
	`list_sync` (cancellable)
	`peek_supported_storages` ()
	`set_default_storage` (storage, cancellable, callback, *user_data)
	`set_default_storage_finish` (res)
	`set_default_storage_sync` (storage, cancellable)

Virtual Methods¶

Inherited:: Gio.DBusProxy (2), GObject.Object (7), Gio.AsyncInitable (2), Gio.DBusInterface (3), Gio.Initable (1), ModemManager.GdbusModemMessaging (6)

Properties¶

Inherited:: Gio.DBusProxy (9), ModemManager.GdbusModemMessaging (3)

Signals¶

Inherited:: Gio.DBusProxy (2), GObject.Object (1), ModemManager.GdbusModemMessaging (6)

Fields¶

Inherited:: Gio.DBusProxy (2), GObject.Object (1), ModemManager.GdbusModemMessaging (6)

Name	Type	Access	Description
parent	`ModemManager.GdbusModemMessagingProxy`	r

Class Details¶

class ModemManager.ModemMessaging(**kwargs)¶

Bases:: ModemManager.GdbusModemMessagingProxy
Abstract:: No
Structure:: ModemManager.ModemMessagingClass

The ModemManager.ModemMessaging structure contains private data and should only be accessed using the provided API.

create(properties, cancellable, callback, *user_data)¶

Parameters:

properties (ModemManager.SmsProperties) – A #:obj:ModemManager.SmsProperties object with the properties to use.
cancellable (Gio.Cancellable or None) – A Gio.Cancellable or None.
callback (Gio.AsyncReadyCallback or None) – A Gio.AsyncReadyCallback to call when the request is satisfied or None.
user_data (object or None) – User data to pass to callback.

Asynchronously creates a new ModemManager.Sms 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 ModemManager.ModemMessaging.create_finish() to get the result of the operation.

See ModemManager.ModemMessaging.create_sync() for the synchronous, blocking version of this method.

New in version 1.0.

create_finish(res)¶

Parameters:: res (Gio.AsyncResult) – The Gio.AsyncResult obtained from the Gio.AsyncReadyCallback passed to ModemManager.ModemMessaging.create().
Raises:: GLib.Error
Returns:: A newly created ModemManager.Sms, or None if error is set. The returned value should be freed with GObject.Object.unref().
Return type:: ModemManager.Sms

Finishes an operation started with ModemManager.ModemMessaging.create().

New in version 1.0.

create_sync(properties, cancellable)¶

Parameters:

properties (ModemManager.SmsProperties) – A #:obj:ModemManager.SmsProperties object with the properties to use.
cancellable (Gio.Cancellable or None) – A Gio.Cancellable or None.

Raises:

GLib.Error

Returns:

A newly created ModemManager.Sms, or None if error is set. The returned value should be freed with GObject.Object.unref().

Return type:

ModemManager.Sms

Synchronously creates a new ModemManager.Sms in the modem.

The calling thread is blocked until a reply is received. See ModemManager.ModemMessaging.create() for the asynchronous version of this method.

New in version 1.0.

delete(sms, cancellable, callback, *user_data)¶

Parameters:

sms (str) – Path of the ModemManager.Sms to delete.
cancellable (Gio.Cancellable or None) – A Gio.Cancellable or None.
callback (Gio.AsyncReadyCallback or None) – A Gio.AsyncReadyCallback to call when the request is satisfied or None.
user_data (object or None) – User data to pass to callback.

Asynchronously deletes a given ModemManager.Sms 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 ModemManager.ModemMessaging.delete_finish() to get the result of the operation.

See ModemManager.ModemMessaging.delete_sync() for the synchronous, blocking version of this method.

New in version 1.0.

delete_finish(res)¶

Parameters:: res (Gio.AsyncResult) – The Gio.AsyncResult obtained from the Gio.AsyncReadyCallback passed to ModemManager.ModemMessaging.delete().
Raises:: GLib.Error
Returns:: True if the sms was deleted, False if error is set.
Return type:: bool

Finishes an operation started with ModemManager.ModemMessaging.delete().

New in version 1.0.

delete_sync(sms, cancellable)¶

Parameters:

sms (str) – Path of the ModemManager.Sms to delete.
cancellable (Gio.Cancellable or None) – A Gio.Cancellable or None.

Raises:

GLib.Error

Returns:

True if the SMS was deleted, False if error is set.

Return type:

bool

Synchronously deletes a given ModemManager.Sms from the modem.

The calling thread is blocked until a reply is received. See ModemManager.ModemMessaging.delete() for the asynchronous version of this method.

New in version 1.0.

dup_path()¶

Returns:: The DBus path of the ModemManager.Object. The returned value should be freed with GLib.free().
Return type:: str

Gets a copy of the DBus path of the ModemManager.Object object which implements this interface.

New in version 1.0.

get_default_storage()¶

Returns:: the default ModemManager.SmsStorage.
Return type:: ModemManager.SmsStorage

Gets the default SMS storage used when storing or receiving SMS messages.

New in version 1.0.

get_path()¶

Returns:: The DBus path of the ModemManager.Object object.
Return type:: str

Gets the DBus path of the ModemManager.Object which implements this interface.

New in version 1.0.

get_supported_storages()¶

Returns:

True if storages and n_storages are set, False otherwise.

storages:: Return location for the array of ModemManager.SmsStorage values. The returned array should be freed with GLib.free() when no longer needed.

Return type:

(bool, storages: [ModemManager.SmsStorage])

Gets the list of SMS storages supported by the ModemManager.Modem.

New in version 1.0.

list(cancellable, callback, *user_data)¶

Parameters:

cancellable (Gio.Cancellable or None) – A Gio.Cancellable or None.
callback (Gio.AsyncReadyCallback or None) – A Gio.AsyncReadyCallback to call when the request is satisfied or None.
user_data (object or None) – User data to pass to callback.

Asynchronously lists the ModemManager.Sms 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 ModemManager.ModemMessaging.list_finish() to get the result of the operation.

See ModemManager.ModemMessaging.list_sync() for the synchronous, blocking version of this method.

New in version 1.0.

list_finish(res)¶

Parameters:: res (Gio.AsyncResult) – The Gio.AsyncResult obtained from the Gio.AsyncReadyCallback passed to ModemManager.ModemMessaging.list().
Raises:: GLib.Error
Returns:: A list of ModemManager.Sms objects, or None if either not found or error is set. The returned value should be freed with g_list_free_full() using GObject.Object.unref() as GLib.DestroyNotify function.
Return type:: [ModemManager.Sms]

Finishes an operation started with ModemManager.ModemMessaging.list().

New in version 1.0.

list_sync(cancellable)¶

Parameters:: cancellable (Gio.Cancellable or None) – A Gio.Cancellable or None.
Raises:: GLib.Error
Returns:: A list of ModemManager.Sms objects, or None if either not found or error is set. The returned value should be freed with g_list_free_full() using GObject.Object.unref() as GLib.DestroyNotify function.
Return type:: [ModemManager.Sms]

Synchronously lists the ModemManager.Sms objects in the modem.

The calling thread is blocked until a reply is received. See ModemManager.ModemMessaging.list() for the asynchronous version of this method.

New in version 1.0.

peek_supported_storages()¶

Returns:

True if storages and n_storages are set, False otherwise.

storages:: Return location for the array of ModemManager.SmsStorage values. Do not free the returned array, it is owned by self.
n_storages:: Return location for the number of values in storages.

Return type:

(bool, storages: ModemManager.SmsStorage, n_storages: int)

Gets the list of SMS storages supported by the ModemManager.Modem.

New in version 1.0.

set_default_storage(storage, cancellable, callback, *user_data)¶

Parameters:

storage (ModemManager.SmsStorage) – A ModemManager.SmsStorage to set default storage.
cancellable (Gio.Cancellable or None) – A Gio.Cancellable or None.
callback (Gio.AsyncReadyCallback or None) – A Gio.AsyncReadyCallback to call when the request is satisfied or None
user_data (object or None) – User data to pass to callback.

Asynchronously set default ModemManager.SmsStorage 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 ModemManager.ModemMessaging.set_default_storage_finish() to get the result of the operation.

See ModemManager.ModemMessaging.set_default_storage_sync() for the synchronous, blocking version of this method.

New in version 1.24.

set_default_storage_finish(res)¶

Parameters:: res (Gio.AsyncResult) – The Gio.AsyncResult obtained from the Gio.AsyncReadyCallback passed to ModemManager.ModemMessaging.set_default_storage()
Raises:: GLib.Error
Returns:: True if set default storage is success, False if error is set.
Return type:: bool

Finishes an operation started with ModemManager.ModemMessaging.set_default_storage().

New in version 1.24.

set_default_storage_sync(storage, cancellable)¶

Parameters:

storage (ModemManager.SmsStorage) – A ModemManager.SmsStorage to set default storage.
cancellable (Gio.Cancellable or None) – A Gio.Cancellable or None.

Raises:

GLib.Error

Returns:

True if set default storage is success, False if error is set.

Return type:

bool

Synchronously set default ModemManager.SmsStorage in the modem.

The calling thread is blocked until a reply is received. See ModemManager.ModemMessaging.set_default_storage() for the asynchronous version of this method.

New in version 1.24.