MMCdmaManualActivationProperties: libmm-glib Reference Manual

MMCdmaManualActivationProperties

MMCdmaManualActivationProperties — Helper object to handle manual CDMA activation properties.

Functions

MMCdmaManualActivationProperties *	mm_cdma_manual_activation_properties_new ()
const gchar *	mm_cdma_manual_activation_properties_get_spc ()
gboolean	mm_cdma_manual_activation_properties_set_spc ()
guint16	mm_cdma_manual_activation_properties_get_sid ()
void	mm_cdma_manual_activation_properties_set_sid ()
const gchar *	mm_cdma_manual_activation_properties_get_mdn ()
gboolean	mm_cdma_manual_activation_properties_set_mdn ()
const gchar *	mm_cdma_manual_activation_properties_get_min ()
gboolean	mm_cdma_manual_activation_properties_set_min ()
const gchar *	mm_cdma_manual_activation_properties_get_mn_ha_key ()
gboolean	mm_cdma_manual_activation_properties_set_mn_ha_key ()
const gchar *	mm_cdma_manual_activation_properties_get_mn_aaa_key ()
gboolean	mm_cdma_manual_activation_properties_set_mn_aaa_key ()
const guint8 *	mm_cdma_manual_activation_properties_get_prl ()
GByteArray *	mm_cdma_manual_activation_properties_peek_prl_bytearray ()
GByteArray *	mm_cdma_manual_activation_properties_get_prl_bytearray ()
gboolean	mm_cdma_manual_activation_properties_set_prl ()
gboolean	mm_cdma_manual_activation_properties_set_prl_bytearray ()

Types and Values

struct

MMCdmaManualActivationProperties

Object Hierarchy

    GObject
    ╰── MMCdmaManualActivationProperties

Description

The MMCdmaManualActivationProperties is an object handling the properties required during a manual CDMA activation request.

Functions

mm_cdma_manual_activation_properties_new ()

MMCdmaManualActivationProperties *
mm_cdma_manual_activation_properties_new
                               (void);

Creates a new MMCdmaManualActivationProperties object.

Returns

A MMCdmaManualActivationProperties. The returned value should be freed with g_object_unref().

[transfer full]

Since: 1.2

mm_cdma_manual_activation_properties_get_spc ()

const gchar *
mm_cdma_manual_activation_properties_get_spc
                               (MMCdmaManualActivationProperties *self);

Gets the Service Programming Code.

Parameters

self

A MMCdmaManualActivationProperties.

Returns

The SPC. Do not free the returned value, it is owned by self .

[transfer none]

Since: 1.2

mm_cdma_manual_activation_properties_set_spc ()

gboolean
mm_cdma_manual_activation_properties_set_spc
                               (MMCdmaManualActivationProperties *self,
                                const gchar *spc,
                                GError **error);

Sets the Service Programming Code.

Parameters

self	A MMCdmaManualActivationProperties.
spc	The SPC string, exactly 6 digits.
error	Return location for error or `NULL`.

Returns

TRUE if the SPC was successfully set, or FALSE if error is set.

Since: 1.2

mm_cdma_manual_activation_properties_get_sid ()

guint16
mm_cdma_manual_activation_properties_get_sid
                               (MMCdmaManualActivationProperties *self);

Gets the System Identification Number.

Parameters

self

A MMCdmaManualActivationProperties.

Returns

The SID.

Since: 1.2

mm_cdma_manual_activation_properties_set_sid ()

void
mm_cdma_manual_activation_properties_set_sid
                               (MMCdmaManualActivationProperties *self,
                                guint16 sid);

Sets the Service Identification Number.

Parameters

self	A MMCdmaManualActivationProperties.
sid	The SID.

Since: 1.2

mm_cdma_manual_activation_properties_get_mdn ()

const gchar *
mm_cdma_manual_activation_properties_get_mdn
                               (MMCdmaManualActivationProperties *self);

Gets the Mobile Directory Number.

Parameters

self

A MMCdmaManualActivationProperties.

Returns

The MDN. Do not free the returned value, it is owned by self .

[transfer none]

Since: 1.2

mm_cdma_manual_activation_properties_set_mdn ()

gboolean
mm_cdma_manual_activation_properties_set_mdn
                               (MMCdmaManualActivationProperties *self,
                                const gchar *mdn,
                                GError **error);

Sets the Mobile Directory Number.

Parameters

self	A MMCdmaManualActivationProperties.
mdn	The MDN string, maximum 15 characters.
error	Return location for error or `NULL`.

Returns

TRUE if the MDN was successfully set, or FALSE if error is set.

Since: 1.2

mm_cdma_manual_activation_properties_get_min ()

const gchar *
mm_cdma_manual_activation_properties_get_min
                               (MMCdmaManualActivationProperties *self);

Gets the Mobile Indentification Number.

Parameters

self

A MMCdmaManualActivationProperties.

Returns

The MIN. Do not free the returned value, it is owned by self .

[transfer none]

Since: 1.2

mm_cdma_manual_activation_properties_set_min ()

gboolean
mm_cdma_manual_activation_properties_set_min
                               (MMCdmaManualActivationProperties *self,
                                const gchar *min,
                                GError **error);

Sets the Mobile Identification Number.

Parameters

self	A MMCdmaManualActivationProperties.
min	The MIN string, maximum 15 characters.
error	Return location for error or `NULL`.

Returns

TRUE if the MIN was successfully set, or FALSE if error is set.

Since: 1.2

mm_cdma_manual_activation_properties_get_mn_ha_key ()

const gchar *
mm_cdma_manual_activation_properties_get_mn_ha_key
                               (MMCdmaManualActivationProperties *self);

Gets the MN-HA key.

Parameters

self

A MMCdmaManualActivationProperties.

Returns

The MN-HA key. Do not free the returned value, it is owned by self .

[transfer none]

Since: 1.2

mm_cdma_manual_activation_properties_set_mn_ha_key ()

gboolean
mm_cdma_manual_activation_properties_set_mn_ha_key
                               (MMCdmaManualActivationProperties *self,
                                const gchar *mn_ha_key,
                                GError **error);

Sets the Mobile Identification Number.

Parameters

self	A MMCdmaManualActivationProperties.
mn_ha_key	The MN-HA key string, maximum 16 characters.
error	Return location for error or `NULL`.

Returns

TRUE if the MN-HA key was successfully set, or FALSE if error is set.

Since: 1.2

mm_cdma_manual_activation_properties_get_mn_aaa_key ()

const gchar *
mm_cdma_manual_activation_properties_get_mn_aaa_key
                               (MMCdmaManualActivationProperties *self);

Gets the MN-AAA key.

Parameters

self

A MMCdmaManualActivationProperties.

Returns

The MN-AAA key. Do not free the returned value, it is owned by self .

[transfer none]

Since: 1.2

mm_cdma_manual_activation_properties_set_mn_aaa_key ()

gboolean
mm_cdma_manual_activation_properties_set_mn_aaa_key
                               (MMCdmaManualActivationProperties *self,
                                const gchar *mn_aaa_key,
                                GError **error);

Sets the Mobile Identification Number.

Parameters

self	A MMCdmaManualActivationProperties.
mn_aaa_key	The MN-AAA key string, maximum 16 characters.
error	Return location for error or `NULL`.

Returns

TRUE if the MN-AAA key was successfully set, or FALSE if error is set.

Since: 1.2

mm_cdma_manual_activation_properties_get_prl ()

const guint8 *
mm_cdma_manual_activation_properties_get_prl
                               (MMCdmaManualActivationProperties *self,
                                gsize *prl_len);

Gets the Preferred Roaming List.

Parameters

self	A MMCdmaManualActivationProperties.
prl_len	Size of the returned PRL.	[out]

Returns

The PRL. Do not free the returned value, it is owned by self .

[transfer none]

Since: 1.2

mm_cdma_manual_activation_properties_peek_prl_bytearray ()

GByteArray *
mm_cdma_manual_activation_properties_peek_prl_bytearray
                               (MMCdmaManualActivationProperties *self);

Gets the Preferred Roaming List.

Parameters

self

A MMCdmaManualActivationProperties.

Returns

A GByteArray with the PRL, or NULL if it doesn't contain any. Do not free the returned value, it is owned by self .

[transfer none]

Since: 1.2

mm_cdma_manual_activation_properties_get_prl_bytearray ()

GByteArray *
mm_cdma_manual_activation_properties_get_prl_bytearray
                               (MMCdmaManualActivationProperties *self);

Gets the Preferred Roaming List.

Parameters

self

A MMCdmaManualActivationProperties.

Returns

A GByteArray with the PRL, or NULL if it doesn't contain any. The returned value should be freed with g_byte_array_unref().

[transfer full]

Since: 1.2

mm_cdma_manual_activation_properties_set_prl ()

gboolean
mm_cdma_manual_activation_properties_set_prl
                               (MMCdmaManualActivationProperties *self,
                                const guint8 *prl,
                                gsize prl_length,
                                GError **error);

Sets the Preferred Roaming List.

Parameters

self	A MMCdmaManualActivationProperties.
prl	The PRL.
prl_length	Length of `prl` .
error	Return location for error or `NULL`.

Returns

TRUE if the PRL was successfully set, or FALSE if error is set.

Since: 1.2

mm_cdma_manual_activation_properties_set_prl_bytearray ()

gboolean
mm_cdma_manual_activation_properties_set_prl_bytearray
                               (MMCdmaManualActivationProperties *self,
                                GByteArray *prl,
                                GError **error);

Sets the Preferred Roaming List.

Parameters

self	A MMCdmaManualActivationProperties.
prl	A GByteArray with the PRL to set. This method takes a new reference of `prl` .
error	Return location for error or `NULL`.

Returns

TRUE if the PRL was successfully set, or FALSE if error is set.

Since: 1.2

Types and Values

struct MMCdmaManualActivationProperties

struct MMCdmaManualActivationProperties;

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