NAS Network Scan response

NAS Network Scan response — Methods to manage the NAS Network Scan response.

Functions

Types and Values

Object Hierarchy

    GBoxed
    ├── QmiMessageNasNetworkScanInput
    ├── QmiMessageNasNetworkScanOutput
    ├── QmiMessageNasNetworkScanOutputMncPcsDigitIncludeStatusElement
    ├── QmiMessageNasNetworkScanOutputNetworkInformationElement
    ╰── QmiMessageNasNetworkScanOutputRadioAccessTechnologyElement

Description

Collection of methods to create requests and parse responses of the NAS Network Scan message.

Functions

qmi_message_nas_network_scan_input_new ()

QmiMessageNasNetworkScanInput *
qmi_message_nas_network_scan_input_new
                               (void);

Allocates a new QmiMessageNasNetworkScanInput.

Returns

the newly created QmiMessageNasNetworkScanInput. The returned value should be freed with qmi_message_nas_network_scan_input_unref().

Since: 1.0


qmi_message_nas_network_scan_input_ref ()

QmiMessageNasNetworkScanInput *
qmi_message_nas_network_scan_input_ref
                               (QmiMessageNasNetworkScanInput *self);

Atomically increments the reference count of self by one.

Parameters

Returns

the new reference to self .

Since: 1.0


qmi_message_nas_network_scan_input_unref ()

void
qmi_message_nas_network_scan_input_unref
                               (QmiMessageNasNetworkScanInput *self);

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

Parameters

Since: 1.0


qmi_message_nas_network_scan_input_get_network_type ()

gboolean
qmi_message_nas_network_scan_input_get_network_type
                               (QmiMessageNasNetworkScanInput *self,
                                QmiNasNetworkScanType *value_network_type,
                                GError **error);

Get the 'Network Type' field from self .

Parameters

self

a QmiMessageNasNetworkScanInput.

 

value_network_type

a placeholder for the output QmiNasNetworkScanType, or NULL if not required.

[out][optional]

error

Return location for error or NULL.

 

Returns

TRUE if the field is found, FALSE otherwise.

[skip]

Since: 1.0


qmi_message_nas_network_scan_input_set_network_type ()

gboolean
qmi_message_nas_network_scan_input_set_network_type
                               (QmiMessageNasNetworkScanInput *self,
                                QmiNasNetworkScanType value_network_type,
                                GError **error);

Set the 'Network Type' field in the message.

Parameters

self

a QmiMessageNasNetworkScanInput.

 

value_network_type

a QmiNasNetworkScanType.

 

error

Return location for error or NULL.

 

Returns

TRUE if value was successfully set, FALSE otherwise.

[skip]

Since: 1.0


qmi_message_nas_network_scan_output_ref ()

QmiMessageNasNetworkScanOutput *
qmi_message_nas_network_scan_output_ref
                               (QmiMessageNasNetworkScanOutput *self);

Atomically increments the reference count of self by one.

Parameters

Returns

the new reference to self .

Since: 1.0


qmi_message_nas_network_scan_output_unref ()

void
qmi_message_nas_network_scan_output_unref
                               (QmiMessageNasNetworkScanOutput *self);

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

Parameters

Since: 1.0


qmi_message_nas_network_scan_output_get_network_scan_result ()

gboolean
qmi_message_nas_network_scan_output_get_network_scan_result
                               (QmiMessageNasNetworkScanOutput *self,
                                QmiNasNetworkScanResult *value_network_scan_result,
                                GError **error);

Get the 'Network Scan Result' field from self .

Parameters

self

a QmiMessageNasNetworkScanOutput.

 

value_network_scan_result

a placeholder for the output QmiNasNetworkScanResult, or NULL if not required.

[out][optional]

error

Return location for error or NULL.

 

Returns

TRUE if the field is found, FALSE otherwise.

[skip]

Since: 1.24


qmi_message_nas_network_scan_output_get_mnc_pcs_digit_include_status ()

gboolean
qmi_message_nas_network_scan_output_get_mnc_pcs_digit_include_status
                               (QmiMessageNasNetworkScanOutput *self,
                                GArray **value_mnc_pcs_digit_include_status,
                                GError **error);

Get the 'MNC PCS Digit Include Status' field from self .

[skip]

Parameters

self

a QmiMessageNasNetworkScanOutput.

 

value_mnc_pcs_digit_include_status

a placeholder for the output GArray of QmiMessageNasNetworkScanOutputMncPcsDigitIncludeStatusElement elements, or NULL if not required. Do not free it, it is owned by self .

[out][optional][element-type QmiMessageNasNetworkScanOutputMncPcsDigitIncludeStatusElement][transfer none]

error

Return location for error or NULL.

 

Returns

TRUE if the field is found, FALSE otherwise.

[skip]

Since: 1.0


qmi_message_nas_network_scan_output_get_mnc_pcs_digit_include_status_gir ()

gboolean
qmi_message_nas_network_scan_output_get_mnc_pcs_digit_include_status_gir
                               (QmiMessageNasNetworkScanOutput *self,
                                GPtrArray **value_mnc_pcs_digit_include_status_ptr,
                                GError **error);

Get the 'MNC PCS Digit Include Status' field from self .

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

[rename-to qmi_message_nas_network_scan_output_get_mnc_pcs_digit_include_status]

Parameters

self

a QmiMessageNasNetworkScanOutput.

 

value_mnc_pcs_digit_include_status_ptr

a placeholder for the output array of QmiMessageNasNetworkScanOutputMncPcsDigitIncludeStatusElement elements, or NULL if not required. Do not free or modify it, it is owned by self .

[out][optional][element-type QmiMessageNasNetworkScanOutputMncPcsDigitIncludeStatusElement][transfer none]

error

Return location for error or NULL.

 

Returns

TRUE if the field is found, FALSE otherwise.

[skip]

Since: 1.32


qmi_message_nas_network_scan_output_get_radio_access_technology ()

gboolean
qmi_message_nas_network_scan_output_get_radio_access_technology
                               (QmiMessageNasNetworkScanOutput *self,
                                GArray **value_radio_access_technology,
                                GError **error);

Get the 'Radio Access Technology' field from self .

[skip]

Parameters

self

a QmiMessageNasNetworkScanOutput.

 

value_radio_access_technology

a placeholder for the output GArray of QmiMessageNasNetworkScanOutputRadioAccessTechnologyElement elements, or NULL if not required. Do not free it, it is owned by self .

[out][optional][element-type QmiMessageNasNetworkScanOutputRadioAccessTechnologyElement][transfer none]

error

Return location for error or NULL.

 

Returns

TRUE if the field is found, FALSE otherwise.

[skip]

Since: 1.0


qmi_message_nas_network_scan_output_get_radio_access_technology_gir ()

gboolean
qmi_message_nas_network_scan_output_get_radio_access_technology_gir
                               (QmiMessageNasNetworkScanOutput *self,
                                GPtrArray **value_radio_access_technology_ptr,
                                GError **error);

Get the 'Radio Access Technology' field from self .

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

[rename-to qmi_message_nas_network_scan_output_get_radio_access_technology]

Parameters

self

a QmiMessageNasNetworkScanOutput.

 

value_radio_access_technology_ptr

a placeholder for the output array of QmiMessageNasNetworkScanOutputRadioAccessTechnologyElement elements, or NULL if not required. Do not free or modify it, it is owned by self .

[out][optional][element-type QmiMessageNasNetworkScanOutputRadioAccessTechnologyElement][transfer none]

error

Return location for error or NULL.

 

Returns

TRUE if the field is found, FALSE otherwise.

[skip]

Since: 1.32


qmi_message_nas_network_scan_output_get_network_information ()

gboolean
qmi_message_nas_network_scan_output_get_network_information
                               (QmiMessageNasNetworkScanOutput *self,
                                GArray **value_network_information,
                                GError **error);

Get the 'Network Information' field from self .

[skip]

Parameters

self

a QmiMessageNasNetworkScanOutput.

 

value_network_information

a placeholder for the output GArray of QmiMessageNasNetworkScanOutputNetworkInformationElement elements, or NULL if not required. Do not free it, it is owned by self .

[out][optional][element-type QmiMessageNasNetworkScanOutputNetworkInformationElement][transfer none]

error

Return location for error or NULL.

 

Returns

TRUE if the field is found, FALSE otherwise.

[skip]

Since: 1.0


qmi_message_nas_network_scan_output_get_network_information_gir ()

gboolean
qmi_message_nas_network_scan_output_get_network_information_gir
                               (QmiMessageNasNetworkScanOutput *self,
                                GPtrArray **value_network_information_ptr,
                                GError **error);

Get the 'Network Information' field from self .

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

[rename-to qmi_message_nas_network_scan_output_get_network_information]

Parameters

self

a QmiMessageNasNetworkScanOutput.

 

value_network_information_ptr

a placeholder for the output array of QmiMessageNasNetworkScanOutputNetworkInformationElement elements, or NULL if not required. Do not free or modify it, it is owned by self .

[out][optional][element-type QmiMessageNasNetworkScanOutputNetworkInformationElement][transfer none]

error

Return location for error or NULL.

 

Returns

TRUE if the field is found, FALSE otherwise.

[skip]

Since: 1.32


qmi_message_nas_network_scan_output_get_result ()

gboolean
qmi_message_nas_network_scan_output_get_result
                               (QmiMessageNasNetworkScanOutput *self,
                                GError **error);

Get the result of the QMI operation.

Parameters

self

a QmiMessageNasNetworkScanOutput.

 

error

Return location for error or NULL.

 

Returns

TRUE if the QMI operation succeeded, FALSE if error is set.

[skip]

Since: 1.0


qmi_message_nas_network_scan_response_parse ()

QmiMessageNasNetworkScanOutput *
qmi_message_nas_network_scan_response_parse
                               (QmiMessage *message,
                                GError **error);

Parses a QmiMessage and builds a QmiMessageNasNetworkScanOutput 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 QmiMessageNasNetworkScanOutput, or NULL if error is set. The returned value should be freed with qmi_message_nas_network_scan_output_unref().

Since: 1.34


qmi_client_nas_network_scan ()

void
qmi_client_nas_network_scan (QmiClientNas *self,
                             QmiMessageNasNetworkScanInput *input,
                             guint timeout,
                             GCancellable *cancellable,
                             GAsyncReadyCallback callback,
                             gpointer user_data);

Asynchronously sends a Network Scan request to the device.

This message is abortable. If cancellable is cancelled or if timeout expires, an abort request will be sent to the device, and the asynchronous operation will not return until the abort response is received. It is not an error if a successful response is returned for the asynchronous operation even after the user has cancelled the cancellable, because it may happen that the response is received before the modem had a chance to run the abort.

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

Parameters

self

a QmiClientNas.

 

input

a QmiMessageNasNetworkScanInput.

 

timeout

maximum time to wait for the method to complete, in seconds.

 

cancellable

a GCancellable or NULL.

 

callback

a GAsyncReadyCallback to call when the request is satisfied.

 

user_data

user data to pass to callback .

 

Since: 1.0


qmi_client_nas_network_scan_finish ()

QmiMessageNasNetworkScanOutput *
qmi_client_nas_network_scan_finish (QmiClientNas *self,
                                    GAsyncResult *res,
                                    GError **error);

Finishes an async operation started with qmi_client_nas_network_scan().

Parameters

self

a QmiClientNas.

 

res

the GAsyncResult obtained from the GAsyncReadyCallback passed to qmi_client_nas_network_scan().

 

error

Return location for error or NULL.

 

Returns

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

Since: 1.0

Types and Values

QmiMessageNasNetworkScanInput

typedef struct _QmiMessageNasNetworkScanInput QmiMessageNasNetworkScanInput;

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

Since: 1.0


QmiMessageNasNetworkScanOutput

typedef struct _QmiMessageNasNetworkScanOutput QmiMessageNasNetworkScanOutput;

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

Since: 1.0


QmiMessageNasNetworkScanOutputMncPcsDigitIncludeStatusElement

typedef struct {
    guint16 mcc;
    guint16 mnc;
    gboolean includes_pcs_digit;
} QmiMessageNasNetworkScanOutputMncPcsDigitIncludeStatusElement;

A QmiMessageNasNetworkScanOutputMncPcsDigitIncludeStatusElement struct.

Members

guint16 mcc;

a guint16.

 

guint16 mnc;

a guint16.

 

gboolean includes_pcs_digit;

a gboolean.

 

Since: 1.0


QmiMessageNasNetworkScanOutputRadioAccessTechnologyElement

typedef struct {
    guint16 mcc;
    guint16 mnc;
    QmiNasRadioInterface radio_interface;
} QmiMessageNasNetworkScanOutputRadioAccessTechnologyElement;

A QmiMessageNasNetworkScanOutputRadioAccessTechnologyElement struct.

Members

guint16 mcc;

a guint16.

 

guint16 mnc;

a guint16.

 

QmiNasRadioInterface radio_interface;

a QmiNasRadioInterface.

 

Since: 1.0


QmiMessageNasNetworkScanOutputNetworkInformationElement

typedef struct {
    guint16 mcc;
    guint16 mnc;
    QmiNasNetworkStatus network_status;
    gchar *description;
} QmiMessageNasNetworkScanOutputNetworkInformationElement;

A QmiMessageNasNetworkScanOutputNetworkInformationElement struct.

Members

guint16 mcc;

a guint16.

 

guint16 mnc;

a guint16.

 

QmiNasNetworkStatus network_status;

a QmiNasNetworkStatus.

 

gchar *description;

a string.

 

Since: 1.0