UIM Card Status indication: libqmi-glib Reference Manual

UIM Card Status indication

UIM Card Status indication — Methods to manage the UIM Card Status indication.

Functions

QmiIndicationUimCardStatusOutput *	qmi_indication_uim_card_status_output_ref ()
void	qmi_indication_uim_card_status_output_unref ()
gboolean	qmi_indication_uim_card_status_output_get_card_status ()
gboolean	qmi_indication_uim_card_status_output_get_card_status_gir ()
QmiIndicationUimCardStatusOutput *	qmi_indication_uim_card_status_indication_parse ()

Types and Values

	QmiIndicationUimCardStatusOutput
	QmiIndicationUimCardStatusOutputCardStatusCardsElementApplicationsElementV2
	QmiIndicationUimCardStatusOutputCardStatusCardsElement
	QmiIndicationUimCardStatusOutputCardStatusCardsElementGir

Object Hierarchy

    GBoxed
    ├── QmiIndicationUimCardStatusOutput
    ├── QmiIndicationUimCardStatusOutputCardStatusCardsElementApplicationsElementV2
    ╰── QmiIndicationUimCardStatusOutputCardStatusCardsElementGir

Description

Collection of methods to parse indications of the UIM Card Status message.

Functions

qmi_indication_uim_card_status_output_ref ()

QmiIndicationUimCardStatusOutput *
qmi_indication_uim_card_status_output_ref
                               (QmiIndicationUimCardStatusOutput *self);

Atomically increments the reference count of self by one.

Parameters

self

a QmiIndicationUimCardStatusOutput.

Returns

the new reference to self .

Since: 1.22

qmi_indication_uim_card_status_output_unref ()

void
qmi_indication_uim_card_status_output_unref
                               (QmiIndicationUimCardStatusOutput *self);

Atomically decrements the reference count of self by one. If the reference count drops to 0, self is completely disposed.

Parameters

self

a QmiIndicationUimCardStatusOutput.

Since: 1.22

qmi_indication_uim_card_status_output_get_card_status ()

gboolean
qmi_indication_uim_card_status_output_get_card_status
                               (QmiIndicationUimCardStatusOutput *self,
                                guint16 *value_card_status_index_gw_primary,
                                guint16 *value_card_status_index_1x_primary,
                                guint16 *value_card_status_index_gw_secondary,
                                guint16 *value_card_status_index_1x_secondary,
                                GArray **value_card_status_cards,
                                GError **error);

Get the 'Card Status' field from self .

[skip]

Parameters

self	a QmiIndicationUimCardStatusOutput.
value_card_status_index_gw_primary	a placeholder for the output guint16, or `NULL` if not required.	[out][optional]
value_card_status_index_1x_primary	a placeholder for the output guint16, or `NULL` if not required.	[out][optional]
value_card_status_index_gw_secondary	a placeholder for the output guint16, or `NULL` if not required.	[out][optional]
value_card_status_index_1x_secondary	a placeholder for the output guint16, or `NULL` if not required.	[out][optional]
value_card_status_cards	a placeholder for the output GArray of QmiIndicationUimCardStatusOutputCardStatusCardsElement elements, or `NULL` if not required. Do not free it, it is owned by `self` .	[out][optional][element-type QmiIndicationUimCardStatusOutputCardStatusCardsElement][transfer none]
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

[skip]

Since: 1.22

qmi_indication_uim_card_status_output_get_card_status_gir ()

gboolean
qmi_indication_uim_card_status_output_get_card_status_gir
                               (QmiIndicationUimCardStatusOutput *self,
                                guint16 *value_card_status_index_gw_primary,
                                guint16 *value_card_status_index_1x_primary,
                                guint16 *value_card_status_index_gw_secondary,
                                guint16 *value_card_status_index_1x_secondary,
                                GPtrArray **value_card_status_cards_ptr,
                                GError **error);

Get the 'Card Status' field from self .

Version of qmi_indication_uim_card_status_output_get_card_status() using arrays of pointers to structs instead of arrays of structs, for easier binding in other languages.

[rename-to qmi_indication_uim_card_status_output_get_card_status]

Parameters

self	a QmiIndicationUimCardStatusOutput.
value_card_status_index_gw_primary	a placeholder for the output guint16, or `NULL` if not required.	[out][optional]
value_card_status_index_1x_primary	a placeholder for the output guint16, or `NULL` if not required.	[out][optional]
value_card_status_index_gw_secondary	a placeholder for the output guint16, or `NULL` if not required.	[out][optional]
value_card_status_index_1x_secondary	a placeholder for the output guint16, or `NULL` if not required.	[out][optional]
value_card_status_cards_ptr	a placeholder for the output array of QmiIndicationUimCardStatusOutputCardStatusCardsElement elements, or `NULL` if not required. Do not free or modify it, it is owned by `self` .	[out][optional][element-type QmiIndicationUimCardStatusOutputCardStatusCardsElementGir][transfer none]
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

[skip]

Since: 1.32

qmi_indication_uim_card_status_indication_parse ()

QmiIndicationUimCardStatusOutput *
qmi_indication_uim_card_status_indication_parse
                               (QmiMessage *message,
                                GError **error);

Parses a QmiMessage and builds a QmiIndicationUimCardStatusOutput out of it. The operation fails if the message is of the wrong type.

Parameters

message	a QmiMessage.
error	return location for error or `NULL`.

Returns

a QmiIndicationUimCardStatusOutput, or NULL if error is set. The returned value should be freed with qmi_indication_uim_card_status_output_unref().

Since: 1.34

Types and Values

QmiIndicationUimCardStatusOutput

typedef struct _QmiIndicationUimCardStatusOutput QmiIndicationUimCardStatusOutput;

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

Since: 1.22

QmiIndicationUimCardStatusOutputCardStatusCardsElementApplicationsElementV2

typedef struct {
    QmiUimCardApplicationType type;
    QmiUimCardApplicationState state;
    QmiUimCardApplicationPersonalizationState personalization_state;
    QmiUimCardApplicationPersonalizationFeatureStatus personalization_feature;
    guint8 personalization_retries;
    guint8 personalization_unblock_retries;
    GArray *application_identifier_value;
    gboolean upin_replaces_pin1;
    QmiUimPinState pin1_state;
    guint8 pin1_retries;
    guint8 puk1_retries;
    QmiUimPinState pin2_state;
    guint8 pin2_retries;
    guint8 puk2_retries;
} QmiIndicationUimCardStatusOutputCardStatusCardsElementApplicationsElementV2;

A QmiIndicationUimCardStatusOutputCardStatusCardsElementApplicationsElementV2 struct.

Members

QmiUimCardApplicationType `type`;	a QmiUimCardApplicationType.
QmiUimCardApplicationState `state`;	a QmiUimCardApplicationState.
QmiUimCardApplicationPersonalizationState `personalization_state`;	a QmiUimCardApplicationPersonalizationState.
QmiUimCardApplicationPersonalizationFeatureStatus `personalization_feature`;	a QmiUimCardApplicationPersonalizationFeatureStatus.
guint8 `personalization_retries`;	a guint8.
guint8 `personalization_unblock_retries`;	a guint8.
GArray *`application_identifier_value`;	a GArray of guint8 elements.
gboolean `upin_replaces_pin1`;	a gboolean.
QmiUimPinState `pin1_state`;	a QmiUimPinState.
guint8 `pin1_retries`;	a guint8.
guint8 `puk1_retries`;	a guint8.
QmiUimPinState `pin2_state`;	a QmiUimPinState.
guint8 `pin2_retries`;	a guint8.
guint8 `puk2_retries`;	a guint8.

Since: 1.34

QmiIndicationUimCardStatusOutputCardStatusCardsElement

typedef struct {
    QmiUimCardState card_state;
    QmiUimPinState upin_state;
    guint8 upin_retries;
    guint8 upuk_retries;
    QmiUimCardError error_code;
    GArray *applications;
} QmiIndicationUimCardStatusOutputCardStatusCardsElement;

A QmiIndicationUimCardStatusOutputCardStatusCardsElement struct.

Members

QmiUimCardState `card_state`;	a QmiUimCardState.
QmiUimPinState `upin_state`;	a QmiUimPinState.
guint8 `upin_retries`;	a guint8.
guint8 `upuk_retries`;	a guint8.
QmiUimCardError `error_code`;	a QmiUimCardError.
GArray *`applications`;	a GArray of QmiIndicationUimCardStatusOutputCardStatusCardsElementApplicationsElementV2 elements.

Since: 1.22

QmiIndicationUimCardStatusOutputCardStatusCardsElementGir

typedef struct {
    QmiUimCardState card_state;
    QmiUimPinState upin_state;
    guint8 upin_retries;
    guint8 upuk_retries;
    QmiUimCardError error_code;
    GPtrArray *applications;
} QmiIndicationUimCardStatusOutputCardStatusCardsElementGir;

A QmiIndicationUimCardStatusOutputCardStatusCardsElementGir struct.

This type is a version of QmiIndicationUimCardStatusOutputCardStatusCardsElement, using arrays of pointers to structs instead of arrays of structs, for easier binding in other languages.

Members

QmiUimCardState `card_state`;	a QmiUimCardState.
QmiUimPinState `upin_state`;	a QmiUimPinState.
guint8 `upin_retries`;	a guint8.
guint8 `upuk_retries`;	a guint8.
QmiUimCardError `error_code`;	a QmiUimCardError.
GPtrArray *`applications`;	an array of QmiIndicationUimCardStatusOutputCardStatusCardsElementApplicationsElementV2 elements.	[element-type QmiIndicationUimCardStatusOutputCardStatusCardsElementApplicationsElementV2]

Since: 1.32