MMModemTime

MMModemTime — The Time interface

Synopsis

struct              MMModemTime;

const gchar *       mm_modem_time_get_path              (MMModemTime *self);
gchar *             mm_modem_time_dup_path              (MMModemTime *self);
MMNetworkTimezone * mm_modem_time_peek_network_timezone (MMModemTime *self);
MMNetworkTimezone * mm_modem_time_get_network_timezone  (MMModemTime *self);

void                mm_modem_time_get_network_time      (MMModemTime *self,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
gchar *             mm_modem_time_get_network_time_finish
                                                        (MMModemTime *self,
                                                         GAsyncResult *res,
                                                         GError **error);
gchar *             mm_modem_time_get_network_time_sync (MMModemTime *self,
                                                         GCancellable *cancellable,
                                                         GError **error);

Object Hierarchy

  GObject
   +----GDBusProxy
         +----MmGdbusModemTimeProxy
               +----MMModemTime

Implemented Interfaces

MMModemTime implements GDBusInterface, GInitable, GAsyncInitable and MmGdbusModemTime.

Description

The MMModemTime is an object providing access to the methods, signals and properties of the Time interface.

The Time interface is exposed on modems which support network time retrieval.

Details

struct MMModemTime

struct MMModemTime;

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


mm_modem_time_get_path ()

const gchar *       mm_modem_time_get_path              (MMModemTime *self);

Gets the DBus path of the MMObject which implements this interface.

self :

A MMModemTime.

Returns :

The DBus path of the MMObject object. [transfer none]

mm_modem_time_dup_path ()

gchar *             mm_modem_time_dup_path              (MMModemTime *self);

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

self :

A MMModemTime.

Returns :

The DBus path of the MMObject. The returned value should be freed with g_free(). [transfer full]

mm_modem_time_peek_network_timezone ()

MMNetworkTimezone * mm_modem_time_peek_network_timezone (MMModemTime *self);


mm_modem_time_get_network_timezone ()

MMNetworkTimezone * mm_modem_time_get_network_timezone  (MMModemTime *self);


mm_modem_time_get_network_time ()

void                mm_modem_time_get_network_time      (MMModemTime *self,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Asynchronously requests the current network time.

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_time_get_network_time_finish() to get the result of the operation.

See mm_modem_time_get_network_time_sync() for the synchronous, blocking version of this method.

self :

A MMModemTime.

cancellable :

A GCancellable or NULL. [allow-none]

callback :

A GAsyncReadyCallback to call when the request is satisfied or NULL.

user_data :

User data to pass to callback.

mm_modem_time_get_network_time_finish ()

gchar *             mm_modem_time_get_network_time_finish
                                                        (MMModemTime *self,
                                                         GAsyncResult *res,
                                                         GError **error);

Finishes an operation started with mm_modem_time_get_network_time().

self :

A MMModemTime.

res :

The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_modem_enable().

error :

Return location for error or NULL.

Returns :

A string containing the network time, or NULL if error is set. The returned value should be freed with g_free().

mm_modem_time_get_network_time_sync ()

gchar *             mm_modem_time_get_network_time_sync (MMModemTime *self,
                                                         GCancellable *cancellable,
                                                         GError **error);

Synchronously requests the current network time.

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

self :

A MMModemTime.

cancellable :

A GCancellable or NULL. [allow-none]

error :

Return location for error or NULL.

Returns :

A string containing the network time, or NULL if error is set. The returned value should be freed with g_free().