libqmi-glib Reference Manual: WDS Get Default Settings

WDS Get Default Settings

Functions

QmiMessageWdsGetDefaultSettingsInput *	qmi_message_wds_get_default_settings_input_new ()
QmiMessageWdsGetDefaultSettingsInput *	qmi_message_wds_get_default_settings_input_ref ()
void	qmi_message_wds_get_default_settings_input_unref ()
gboolean	qmi_message_wds_get_default_settings_input_get_profile_type ()
gboolean	qmi_message_wds_get_default_settings_input_set_profile_type ()
QmiMessageWdsGetDefaultSettingsOutput *	qmi_message_wds_get_default_settings_output_ref ()
void	qmi_message_wds_get_default_settings_output_unref ()
gboolean	qmi_message_wds_get_default_settings_output_get_result ()
gboolean	qmi_message_wds_get_default_settings_output_get_ipv6_address_preference ()
gboolean	qmi_message_wds_get_default_settings_output_get_profile_name ()
gboolean	qmi_message_wds_get_default_settings_output_get_pdp_type ()
gboolean	qmi_message_wds_get_default_settings_output_get_apn_name ()
gboolean	qmi_message_wds_get_default_settings_output_get_primary_ipv4_dns_address ()
gboolean	qmi_message_wds_get_default_settings_output_get_secondary_ipv4_dns_address ()
gboolean	qmi_message_wds_get_default_settings_output_get_gprs_requested_qos ()
gboolean	qmi_message_wds_get_default_settings_output_get_gprs_minimum_qos ()
gboolean	qmi_message_wds_get_default_settings_output_get_username ()
gboolean	qmi_message_wds_get_default_settings_output_get_password ()
gboolean	qmi_message_wds_get_default_settings_output_get_authentication ()
gboolean	qmi_message_wds_get_default_settings_output_get_ipv4_address_preference ()
gboolean	qmi_message_wds_get_default_settings_output_get_pcscf_address_using_pco ()
gboolean	qmi_message_wds_get_default_settings_output_get_pcscf_address_using_dhcp ()
gboolean	qmi_message_wds_get_default_settings_output_get_imcn_flag ()
gboolean	qmi_message_wds_get_default_settings_output_get_ipv6_primary_dns_address_preference ()
gboolean	qmi_message_wds_get_default_settings_output_get_ipv6_secondary_dns_address_preference ()
gboolean	qmi_message_wds_get_default_settings_output_get_extended_error_code ()
void	qmi_client_wds_get_default_settings ()
QmiMessageWdsGetDefaultSettingsOutput *	qmi_client_wds_get_default_settings_finish ()

Types and Values

	QmiMessageWdsGetDefaultSettingsInput
	QmiMessageWdsGetDefaultSettingsOutput

Object Hierarchy

    GBoxed
    ├── QmiMessageWdsGetDefaultSettingsInput
    ╰── QmiMessageWdsGetDefaultSettingsOutput

Description

Functions

qmi_message_wds_get_default_settings_input_new ()

QmiMessageWdsGetDefaultSettingsInput *
qmi_message_wds_get_default_settings_input_new
                               (void);

Allocates a new QmiMessageWdsGetDefaultSettingsInput.

Returns

the newly created QmiMessageWdsGetDefaultSettingsInput. The returned value should be freed with qmi_message_wds_get_default_settings_input_unref().

qmi_message_wds_get_default_settings_input_ref ()

QmiMessageWdsGetDefaultSettingsInput *
qmi_message_wds_get_default_settings_input_ref
                               (QmiMessageWdsGetDefaultSettingsInput *self);

Atomically increments the reference count of self by one.

Parameters

self

a QmiMessageWdsGetDefaultSettingsInput.

Returns

the new reference to self .

qmi_message_wds_get_default_settings_input_unref ()

void
qmi_message_wds_get_default_settings_input_unref
                               (QmiMessageWdsGetDefaultSettingsInput *self);

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

Parameters

self

a QmiMessageWdsGetDefaultSettingsInput.

qmi_message_wds_get_default_settings_input_get_profile_type ()

gboolean
qmi_message_wds_get_default_settings_input_get_profile_type
                               (QmiMessageWdsGetDefaultSettingsInput *self,
                                QmiWdsProfileType *profile_type,
                                GError **error);

Get the 'Profile Type' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsInput.
profile_type	a placeholder for the output QmiWdsProfileType, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_input_set_profile_type ()

gboolean
qmi_message_wds_get_default_settings_input_set_profile_type
                               (QmiMessageWdsGetDefaultSettingsInput *self,
                                QmiWdsProfileType profile_type,
                                GError **error);

Set the 'Profile Type' field in the message.

Parameters

self	a QmiMessageWdsGetDefaultSettingsInput.
profile_type	a QmiWdsProfileType.
error	Return location for error or `NULL`.

Returns

TRUE if value was successfully set, FALSE otherwise.

qmi_message_wds_get_default_settings_output_ref ()

QmiMessageWdsGetDefaultSettingsOutput *
qmi_message_wds_get_default_settings_output_ref
                               (QmiMessageWdsGetDefaultSettingsOutput *self);

Atomically increments the reference count of self by one.

Parameters

self

a QmiMessageWdsGetDefaultSettingsOutput.

Returns

the new reference to self .

qmi_message_wds_get_default_settings_output_unref ()

void
qmi_message_wds_get_default_settings_output_unref
                               (QmiMessageWdsGetDefaultSettingsOutput *self);

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

Parameters

self

a QmiMessageWdsGetDefaultSettingsOutput.

qmi_message_wds_get_default_settings_output_get_result ()

gboolean
qmi_message_wds_get_default_settings_output_get_result
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                GError **error);

Get the result of the QMI operation.

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
error	Return location for error or `NULL`.

Returns

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

qmi_message_wds_get_default_settings_output_get_ipv6_address_preference ()

gboolean
qmi_message_wds_get_default_settings_output_get_ipv6_address_preference
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                GArray **ipv6_address_preference_address,
                                GError **error);

Get the 'IPv6 Address Preference' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
ipv6_address_preference_address	a placeholder for the output GArray of guint16 elements, or `NULL` if not required. Do not free it, it is owned by `self` .
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_profile_name ()

gboolean
qmi_message_wds_get_default_settings_output_get_profile_name
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                const gchar **profile_name,
                                GError **error);

Get the 'Profile Name' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
profile_name	a placeholder for the output constant string, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_pdp_type ()

gboolean
qmi_message_wds_get_default_settings_output_get_pdp_type
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                QmiWdsPdpType *pdp_type,
                                GError **error);

Get the 'PDP Type' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
pdp_type	a placeholder for the output QmiWdsPdpType, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_apn_name ()

gboolean
qmi_message_wds_get_default_settings_output_get_apn_name
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                const gchar **apn_name,
                                GError **error);

Get the 'APN Name' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
apn_name	a placeholder for the output constant string, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_primary_ipv4_dns_address ()

gboolean
qmi_message_wds_get_default_settings_output_get_primary_ipv4_dns_address
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                guint32 *primary_ipv4_dns_address,
                                GError **error);

Get the 'Primary IPv4 DNS Address' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
primary_ipv4_dns_address	a placeholder for the output guint32, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_secondary_ipv4_dns_address ()

gboolean
qmi_message_wds_get_default_settings_output_get_secondary_ipv4_dns_address
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                guint32 *secondary_ipv4_dns_address,
                                GError **error);

Get the 'Secondary IPv4 DNS Address' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
secondary_ipv4_dns_address	a placeholder for the output guint32, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_gprs_requested_qos ()

gboolean
qmi_message_wds_get_default_settings_output_get_gprs_requested_qos
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                guint32 *gprs_requested_qos_precedence_class,
                                guint32 *gprs_requested_qos_delay_class,
                                guint32 *gprs_requested_qos_reliability_class,
                                guint32 *gprs_requested_qos_peak_throughput_class,
                                guint32 *gprs_requested_qos_mean_throughput_class,
                                GError **error);

Get the 'GPRS Requested QoS' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
gprs_requested_qos_precedence_class	a placeholder for the output guint32, or `NULL` if not required.
gprs_requested_qos_delay_class	a placeholder for the output guint32, or `NULL` if not required.
gprs_requested_qos_reliability_class	a placeholder for the output guint32, or `NULL` if not required.
gprs_requested_qos_peak_throughput_class	a placeholder for the output guint32, or `NULL` if not required.
gprs_requested_qos_mean_throughput_class	a placeholder for the output guint32, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_gprs_minimum_qos ()

gboolean
qmi_message_wds_get_default_settings_output_get_gprs_minimum_qos
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                guint32 *gprs_minimum_qos_precedence_class,
                                guint32 *gprs_minimum_qos_delay_class,
                                guint32 *gprs_minimum_qos_reliability_class,
                                guint32 *gprs_minimum_qos_peak_throughput_class,
                                guint32 *gprs_minimum_qos_mean_throughput_class,
                                GError **error);

Get the 'GPRS Minimum QoS' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
gprs_minimum_qos_precedence_class	a placeholder for the output guint32, or `NULL` if not required.
gprs_minimum_qos_delay_class	a placeholder for the output guint32, or `NULL` if not required.
gprs_minimum_qos_reliability_class	a placeholder for the output guint32, or `NULL` if not required.
gprs_minimum_qos_peak_throughput_class	a placeholder for the output guint32, or `NULL` if not required.
gprs_minimum_qos_mean_throughput_class	a placeholder for the output guint32, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_username ()

gboolean
qmi_message_wds_get_default_settings_output_get_username
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                const gchar **username,
                                GError **error);

Get the 'Username' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
username	a placeholder for the output constant string, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_password ()

gboolean
qmi_message_wds_get_default_settings_output_get_password
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                const gchar **password,
                                GError **error);

Get the 'Password' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
password	a placeholder for the output constant string, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_authentication ()

gboolean
qmi_message_wds_get_default_settings_output_get_authentication
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                QmiWdsAuthentication *authentication,
                                GError **error);

Get the 'Authentication' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
authentication	a placeholder for the output QmiWdsAuthentication, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_ipv4_address_preference ()

gboolean
qmi_message_wds_get_default_settings_output_get_ipv4_address_preference
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                guint32 *ipv4_address_preference,
                                GError **error);

Get the 'IPv4 Address Preference' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
ipv4_address_preference	a placeholder for the output guint32, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_pcscf_address_using_pco ()

gboolean
qmi_message_wds_get_default_settings_output_get_pcscf_address_using_pco
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                gboolean *pcscf_address_using_pco,
                                GError **error);

Get the 'PCSCF Address Using PCO' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
pcscf_address_using_pco	a placeholder for the output gboolean, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_pcscf_address_using_dhcp ()

gboolean
qmi_message_wds_get_default_settings_output_get_pcscf_address_using_dhcp
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                gboolean *pcscf_address_using_dhcp,
                                GError **error);

Get the 'PCSCF Address Using DHCP' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
pcscf_address_using_dhcp	a placeholder for the output gboolean, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_imcn_flag ()

gboolean
qmi_message_wds_get_default_settings_output_get_imcn_flag
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                gboolean *imcn_flag,
                                GError **error);

Get the 'IMCN Flag' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
imcn_flag	a placeholder for the output gboolean, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_ipv6_primary_dns_address_preference ()

gboolean
qmi_message_wds_get_default_settings_output_get_ipv6_primary_dns_address_preference
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                GArray **ipv6_primary_dns_address_preference,
                                GError **error);

Get the 'IPv6 Primary DNS Address Preference' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
ipv6_primary_dns_address_preference	a placeholder for the output GArray of guint16 elements, or `NULL` if not required. Do not free it, it is owned by `self` .
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_ipv6_secondary_dns_address_preference ()

gboolean
qmi_message_wds_get_default_settings_output_get_ipv6_secondary_dns_address_preference
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                GArray **ipv6_secondary_dns_address_preference,
                                GError **error);

Get the 'IPv6 Secondary DNS Address Preference' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
ipv6_secondary_dns_address_preference	a placeholder for the output GArray of guint16 elements, or `NULL` if not required. Do not free it, it is owned by `self` .
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_message_wds_get_default_settings_output_get_extended_error_code ()

gboolean
qmi_message_wds_get_default_settings_output_get_extended_error_code
                               (QmiMessageWdsGetDefaultSettingsOutput *self,
                                QmiWdsDsProfileError *extended_error_code,
                                GError **error);

Get the 'Extended Error Code' field from self .

Parameters

self	a QmiMessageWdsGetDefaultSettingsOutput.
extended_error_code	a placeholder for the output QmiWdsDsProfileError, or `NULL` if not required.
error	Return location for error or `NULL`.

Returns

TRUE if the field is found, FALSE otherwise.

qmi_client_wds_get_default_settings ()

void
qmi_client_wds_get_default_settings (QmiClientWds *self,
                                     QmiMessageWdsGetDefaultSettingsInput *input,
                                     guint timeout,
                                     GCancellable *cancellable,
                                     GAsyncReadyCallback callback,
                                     gpointer user_data);

Asynchronously sends a Get Default Settings request to the device.

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

Parameters

self	a QmiClientWds.
input	a QmiMessageWdsGetDefaultSettingsInput.
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` .

qmi_client_wds_get_default_settings_finish ()

QmiMessageWdsGetDefaultSettingsOutput *
qmi_client_wds_get_default_settings_finish
                               (QmiClientWds *self,
                                GAsyncResult *res,
                                GError **error);

Finishes an async operation started with qmi_client_wds_get_default_settings().

Parameters

self	a QmiClientWds.
res	the GAsyncResult obtained from the GAsyncReadyCallback passed to `qmi_client_wds_get_default_settings()`.
error	Return location for error or `NULL`.

Returns

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

Types and Values

QmiMessageWdsGetDefaultSettingsInput

typedef struct _QmiMessageWdsGetDefaultSettingsInput QmiMessageWdsGetDefaultSettingsInput;

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

QmiMessageWdsGetDefaultSettingsOutput

typedef struct _QmiMessageWdsGetDefaultSettingsOutput QmiMessageWdsGetDefaultSettingsOutput;

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