MMSimpleConnectProperties

MMSimpleConnectProperties — Helper object to handle connection properties.

Synopsis

struct              MMSimpleConnectProperties;

MMSimpleConnectProperties * mm_simple_connect_properties_new
                                                        (void);

const gchar *       mm_simple_connect_properties_get_pin
                                                        (MMSimpleConnectProperties *self);
void                mm_simple_connect_properties_set_pin
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *pin);
const gchar *       mm_simple_connect_properties_get_operator_id
                                                        (MMSimpleConnectProperties *self);
void                mm_simple_connect_properties_set_operator_id
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *operator_id);
gboolean            mm_simple_connect_properties_get_bands
                                                        (MMSimpleConnectProperties *self,
                                                         const MMModemBand **bands,
                                                         guint *n_bands);
void                mm_simple_connect_properties_set_bands
                                                        (MMSimpleConnectProperties *self,
                                                         const MMModemBand *bands,
                                                         guint n_bands);
gboolean            mm_simple_connect_properties_get_allowed_modes
                                                        (MMSimpleConnectProperties *self,
                                                         MMModemMode *allowed,
                                                         MMModemMode *preferred);
void                mm_simple_connect_properties_set_allowed_modes
                                                        (MMSimpleConnectProperties *self,
                                                         MMModemMode allowed,
                                                         MMModemMode preferred);
const gchar *       mm_simple_connect_properties_get_apn
                                                        (MMSimpleConnectProperties *self);
void                mm_simple_connect_properties_set_apn
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *apn);
MMBearerAllowedAuth mm_simple_connect_properties_get_allowed_auth
                                                        (MMSimpleConnectProperties *self);
void                mm_simple_connect_properties_set_allowed_auth
                                                        (MMSimpleConnectProperties *self,
                                                         MMBearerAllowedAuth allowed_auth);
const gchar *       mm_simple_connect_properties_get_user
                                                        (MMSimpleConnectProperties *self);
void                mm_simple_connect_properties_set_user
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *user);
const gchar *       mm_simple_connect_properties_get_password
                                                        (MMSimpleConnectProperties *self);
void                mm_simple_connect_properties_set_password
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *password);
MMBearerIpFamily    mm_simple_connect_properties_get_ip_type
                                                        (MMSimpleConnectProperties *self);
void                mm_simple_connect_properties_set_ip_type
                                                        (MMSimpleConnectProperties *self,
                                                         MMBearerIpFamily ip_type);
gboolean            mm_simple_connect_properties_get_allow_roaming
                                                        (MMSimpleConnectProperties *self);
void                mm_simple_connect_properties_set_allow_roaming
                                                        (MMSimpleConnectProperties *self,
                                                         gboolean allow_roaming);
const gchar *       mm_simple_connect_properties_get_number
                                                        (MMSimpleConnectProperties *self);
void                mm_simple_connect_properties_set_number
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *number);

Object Hierarchy

  GObject
   +----MMSimpleConnectProperties

Description

The MMSimpleConnectProperties is an object handling the properties requested to ModemManager when launching a connection with the Simple interface.

This object is created by the user and passed to ModemManager with either mm_modem_simple_connect() or mm_modem_simple_connect_sync().

Details

struct MMSimpleConnectProperties

struct MMSimpleConnectProperties;

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


mm_simple_connect_properties_new ()

MMSimpleConnectProperties * mm_simple_connect_properties_new
                                                        (void);

Creates a new empty MMSimpleConnectProperties.

Returns :

a MMSimpleConnectProperties. The returned value should be freed with g_object_unref(). [transfer full]

mm_simple_connect_properties_get_pin ()

const gchar *       mm_simple_connect_properties_get_pin
                                                        (MMSimpleConnectProperties *self);

Gets the PIN code to use when unlocking the modem.

self :

a MMSimpleConnectProperties.

Returns :

the PIN, or NULL if not set. Do not free the returned value, it is owned by self. [transfer none]

mm_simple_connect_properties_set_pin ()

void                mm_simple_connect_properties_set_pin
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *pin);

Sets the PIN code to use when unlocking the modem.

self :

a MMSimpleConnectProperties.

pin :

PIN code.

mm_simple_connect_properties_get_operator_id ()

const gchar *       mm_simple_connect_properties_get_operator_id
                                                        (MMSimpleConnectProperties *self);

Gets the ID of the network to which register before connecting.

self :

a MMSimpleConnectProperties.

Returns :

the operator ID, or NULL if not set. Do not free the returned value, it is owned by self. [transfer none]

mm_simple_connect_properties_set_operator_id ()

void                mm_simple_connect_properties_set_operator_id
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *operator_id);

Sets the ID of the network to which register before connecting.

self :

a MMSimpleConnectProperties.

operator_id :

operator ID, given as MCC/MNC.

mm_simple_connect_properties_get_bands ()

gboolean            mm_simple_connect_properties_get_bands
                                                        (MMSimpleConnectProperties *self,
                                                         const MMModemBand **bands,
                                                         guint *n_bands);

Gets the frequency bands to use.

self :

a MMSimpleConnectProperties.

bands :

location for the array of MMModemBand values. Do not free the returned value, it is owned by self. [out]

n_bands :

(out) number of elements in bands.

Returns :

TRUE if bands is set, FALSE otherwise.

mm_simple_connect_properties_set_bands ()

void                mm_simple_connect_properties_set_bands
                                                        (MMSimpleConnectProperties *self,
                                                         const MMModemBand *bands,
                                                         guint n_bands);

Sets the frequency bands to use.

self :

a MMSimpleConnectProperties.

bands :

array of MMModemBand values.

n_bands :

number of elements in bands.

mm_simple_connect_properties_get_allowed_modes ()

gboolean            mm_simple_connect_properties_get_allowed_modes
                                                        (MMSimpleConnectProperties *self,
                                                         MMModemMode *allowed,
                                                         MMModemMode *preferred);

Gets the modes allowed to use, and which of them is preferred.

self :

a MMSimpleConnectProperties.

allowed :

location for the bitmask of MMModemMode values specifying which are allowed. [out]

preferred :

loction for a MMModemMode value, specifying which of the ones in allowed is preferred, if any. [out]

Returns :

TRUE if allowed and preferred are set, FALSE otherwise.

mm_simple_connect_properties_set_allowed_modes ()

void                mm_simple_connect_properties_set_allowed_modes
                                                        (MMSimpleConnectProperties *self,
                                                         MMModemMode allowed,
                                                         MMModemMode preferred);

Sets the modes allowed to use, and which of them is preferred.

self :

a MMSimpleConnectProperties.

allowed :

bitmask of MMModemMode values specifying which are allowed.

preferred :

a MMModemMode value, specifying which of the ones in allowed is preferred, if any.

mm_simple_connect_properties_get_apn ()

const gchar *       mm_simple_connect_properties_get_apn
                                                        (MMSimpleConnectProperties *self);

Gets the name of the access point to use when connecting.

self :

a MMSimpleConnectProperties.

Returns :

the access point, or NULL if not set. Do not free the returned value, it is owned by self. [transfer none]

mm_simple_connect_properties_set_apn ()

void                mm_simple_connect_properties_set_apn
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *apn);

Sets the name of the access point to use when connecting.

self :

a MMSimpleConnectProperties.

apn :

Name of the access point.

mm_simple_connect_properties_get_allowed_auth ()

MMBearerAllowedAuth mm_simple_connect_properties_get_allowed_auth
                                                        (MMSimpleConnectProperties *self);

Gets the authentication methods allowed in the connection.

self :

a MMSimpleConnectProperties.

Returns :

a bitmask of MMBearerAllowedAuth values, or MM_BEARER_ALLOWED_AUTH_UNKNOWN to request the modem-default method.

mm_simple_connect_properties_set_allowed_auth ()

void                mm_simple_connect_properties_set_allowed_auth
                                                        (MMSimpleConnectProperties *self,
                                                         MMBearerAllowedAuth allowed_auth);

Sets the authentication method to use.

self :

a MMSimpleConnectProperties.

allowed_auth :

a bitmask of MMBearerAllowedAuth values. MM_BEARER_ALLOWED_AUTH_UNKNOWN may be given to request the modem-default method.

mm_simple_connect_properties_get_user ()

const gchar *       mm_simple_connect_properties_get_user
                                                        (MMSimpleConnectProperties *self);

Gets the username used to authenticate with the access point.

self :

a MMSimpleConnectProperties.

Returns :

the username, or NULL if not set. Do not free the returned value, it is owned by self. [transfer none]

mm_simple_connect_properties_set_user ()

void                mm_simple_connect_properties_set_user
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *user);

Sets the username used to authenticate with the access point.

self :

a MMSimpleConnectProperties.

user :

the username

mm_simple_connect_properties_get_password ()

const gchar *       mm_simple_connect_properties_get_password
                                                        (MMSimpleConnectProperties *self);

Gets the password used to authenticate with the access point.

self :

a MMSimpleConnectProperties.

Returns :

the password, or NULL if not set. Do not free the returned value, it is owned by self. [transfer none]

mm_simple_connect_properties_set_password ()

void                mm_simple_connect_properties_set_password
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *password);

Sets the password used to authenticate with the access point.

self :

a MMSimpleConnectProperties.

password :

the password

mm_simple_connect_properties_get_ip_type ()

MMBearerIpFamily    mm_simple_connect_properties_get_ip_type
                                                        (MMSimpleConnectProperties *self);

Sets the IP type to use.

self :

a MMSimpleConnectProperties.

Returns :

a MMBearerIpFamily.

mm_simple_connect_properties_set_ip_type ()

void                mm_simple_connect_properties_set_ip_type
                                                        (MMSimpleConnectProperties *self,
                                                         MMBearerIpFamily ip_type);

Sets the IP type to use.

self :

a MMSimpleConnectProperties.

ip_type :

a MMBearerIpFamily.

mm_simple_connect_properties_get_allow_roaming ()

gboolean            mm_simple_connect_properties_get_allow_roaming
                                                        (MMSimpleConnectProperties *self);

Checks whether roaming is allowed in the connection.

self :

a MMSimpleConnectProperties.

Returns :

TRUE if roaming is allowed, FALSE otherwise..

mm_simple_connect_properties_set_allow_roaming ()

void                mm_simple_connect_properties_set_allow_roaming
                                                        (MMSimpleConnectProperties *self,
                                                         gboolean allow_roaming);

Sets the flag to indicate whether roaming is allowed or not in the connection.

self :

a MMSimpleConnectProperties.

allow_roaming :

boolean value.

mm_simple_connect_properties_get_number ()

const gchar *       mm_simple_connect_properties_get_number
                                                        (MMSimpleConnectProperties *self);

Gets the number to use when performing the connection.

self :

a MMSimpleConnectProperties.

Returns :

the number, or NULL if not set. Do not free the returned value, it is owned by self. [transfer none]

mm_simple_connect_properties_set_number ()

void                mm_simple_connect_properties_set_number
                                                        (MMSimpleConnectProperties *self,
                                                         const gchar *number);

Sets the number to use when performing the connection.

self :

a MMSimpleConnectProperties.

number :

the number.