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 (16)
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` ()

Virtual Methods¶

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

Properties¶

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

Signals¶

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

Fields¶

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

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.