## DMS Set Firmware Preference DMS Set Firmware Preference |

## Synopsis

                        QmiMessageDmsSetFirmwarePreferenceInput;
                        QmiMessageDmsSetFirmwarePreferenceInputListImage;
                        QmiMessageDmsSetFirmwarePreferenceOutput;

    QmiMessageDmsSetFirmwarePreferenceInput * qmi_message_dms_set_firmware_preference_input_new
                                                            (void);
    QmiMessageDmsSetFirmwarePreferenceInput * qmi_message_dms_set_firmware_preference_input_ref
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self);
    void                qmi_message_dms_set_firmware_preference_input_unref
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self);
    gboolean            qmi_message_dms_set_firmware_preference_input_get_modem_storage_index
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             guint8 *modem_storage_index,
                                                             GError **error);
    gboolean            qmi_message_dms_set_firmware_preference_input_set_modem_storage_index
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             guint8 modem_storage_index,
                                                             GError **error);
    gboolean            qmi_message_dms_set_firmware_preference_input_get_download_override
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             gboolean *download_override,
                                                             GError **error);
    gboolean            qmi_message_dms_set_firmware_preference_input_set_download_override
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             gboolean download_override,
                                                             GError **error);
    gboolean            qmi_message_dms_set_firmware_preference_input_get_list
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             GArray **list,
                                                             GError **error);
    gboolean            qmi_message_dms_set_firmware_preference_input_set_list
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             GArray *list,
                                                             GError **error);

    QmiMessageDmsSetFirmwarePreferenceOutput * qmi_message_dms_set_firmware_preference_output_ref
                                                            (QmiMessageDmsSetFirmwarePreferenceOutput *self);
    void                qmi_message_dms_set_firmware_preference_output_unref
                                                            (QmiMessageDmsSetFirmwarePreferenceOutput *self);
    gboolean            qmi_message_dms_set_firmware_preference_output_get_result
                                                            (QmiMessageDmsSetFirmwarePreferenceOutput *self,
                                                             GError **error);
    gboolean            qmi_message_dms_set_firmware_preference_output_get_image_download_list
                                                            (QmiMessageDmsSetFirmwarePreferenceOutput *self,
                                                             GArray **image_download_list,
                                                             GError **error);

    void                qmi_client_dms_set_firmware_preference
                                                            (QmiClientDms *self,
                                                             QmiMessageDmsSetFirmwarePreferenceInput *input,
                                                             guint timeout,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    QmiMessageDmsSetFirmwarePreferenceOutput * qmi_client_dms_set_firmware_preference_finish
                                                            (QmiClientDms *self,
                                                             GAsyncResult *res,
                                                             GError **error);

## Object Hierarchy

      GBoxed
       +----QmiMessageDmsSetFirmwarePreferenceInput

      GBoxed
       +----QmiMessageDmsSetFirmwarePreferenceOutput

## Description

## Details

### QmiMessageDmsSetFirmwarePreferenceInput

    typedef struct _QmiMessageDmsSetFirmwarePreferenceInput QmiMessageDmsSetFirmwarePreferenceInput;

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

### QmiMessageDmsSetFirmwarePreferenceInputListImage

    typedef struct {
        QmiDmsFirmwareImageType type;
        GArray * unique_id;
        gchar * build_id;
    } QmiMessageDmsSetFirmwarePreferenceInputListImage;

A QmiMessageDmsSetFirmwarePreferenceInputListImage struct.

QmiDmsFirmwareImageType `type`; | a QmiDmsFirmwareImageType.
GArray *`unique_id`; | a GArray of guint8 elements.
gchar *`build_id`; | a string.

### QmiMessageDmsSetFirmwarePreferenceOutput

    typedef struct _QmiMessageDmsSetFirmwarePreferenceOutput QmiMessageDmsSetFirmwarePreferenceOutput;

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

### qmi_message_dms_set_firmware_preference_input_new ()

    QmiMessageDmsSetFirmwarePreferenceInput * qmi_message_dms_set_firmware_preference_input_new
                                                            (void);

Allocates a new QmiMessageDmsSetFirmwarePreferenceInput.

Returns : | the newly created QmiMessageDmsSetFirmwarePreferenceInput. The returned value should be freed with `qmi_message_dms_set_firmware_preference_input_unref()`.

### qmi_message_dms_set_firmware_preference_input_ref ()

    QmiMessageDmsSetFirmwarePreferenceInput * qmi_message_dms_set_firmware_preference_input_ref
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self);

Atomically increments the reference count of `self` by one.

`self` : | a QmiMessageDmsSetFirmwarePreferenceInput.
Returns : | the new reference to `self`.

### qmi_message_dms_set_firmware_preference_input_unref ()

    void                qmi_message_dms_set_firmware_preference_input_unref
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self);

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

`self` : | a QmiMessageDmsSetFirmwarePreferenceInput.

### qmi_message_dms_set_firmware_preference_input_get_modem_storage_index ()

    gboolean            qmi_message_dms_set_firmware_preference_input_get_modem_storage_index
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             guint8 *modem_storage_index,
                                                             GError **error);

Get the 'Modem Storage Index' field from `self`.

`self` : | a QmiMessageDmsSetFirmwarePreferenceInput.
`modem_storage_index` : | a placeholder for the output guint8, or `NULL` if not required.
`error` : | Return location for error or `NULL`.
Returns : | `TRUE` if the field is found, `FALSE` otherwise.

### qmi_message_dms_set_firmware_preference_input_set_modem_storage_index ()

    gboolean            qmi_message_dms_set_firmware_preference_input_set_modem_storage_index
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             guint8 modem_storage_index,
                                                             GError **error);

Set the 'Modem Storage Index' field in the message.

`self` : | a QmiMessageDmsSetFirmwarePreferenceInput.
`modem_storage_index` : | a guint8.
`error` : | Return location for error or `NULL`.
Returns : | `TRUE` if `value` was successfully set, `FALSE` otherwise.

### qmi_message_dms_set_firmware_preference_input_get_download_override ()

    gboolean            qmi_message_dms_set_firmware_preference_input_get_download_override
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             gboolean *download_override,
                                                             GError **error);

Get the 'Download Override' field from `self`.

`self` : | a QmiMessageDmsSetFirmwarePreferenceInput.
`download_override` : | 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_dms_set_firmware_preference_input_set_download_override ()

    gboolean            qmi_message_dms_set_firmware_preference_input_set_download_override
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             gboolean download_override,
                                                             GError **error);

Set the 'Download Override' field in the message.

`self` : | a QmiMessageDmsSetFirmwarePreferenceInput.
`download_override` : | a gboolean.
`error` : | Return location for error or `NULL`.
Returns : | `TRUE` if `value` was successfully set, `FALSE` otherwise.

### qmi_message_dms_set_firmware_preference_input_get_list ()

    gboolean            qmi_message_dms_set_firmware_preference_input_get_list
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             GArray **list,
                                                             GError **error);

Get the 'List' field from `self`.

`self` : | a QmiMessageDmsSetFirmwarePreferenceInput.
`list` : | a placeholder for the output GArray of QmiMessageDmsSetFirmwarePreferenceInputListImage 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_dms_set_firmware_preference_input_set_list ()

    gboolean            qmi_message_dms_set_firmware_preference_input_set_list
                                                            (QmiMessageDmsSetFirmwarePreferenceInput *self,
                                                             GArray *list,
                                                             GError **error);

Set the 'List' field in the message.

`self` : | a QmiMessageDmsSetFirmwarePreferenceInput.
`list` : | a GArray of QmiMessageDmsSetFirmwarePreferenceInputListImage elements. A new reference to `list` will be taken.
`error` : | Return location for error or `NULL`.
Returns : | `TRUE` if `value` was successfully set, `FALSE` otherwise.

### qmi_message_dms_set_firmware_preference_output_ref ()

    QmiMessageDmsSetFirmwarePreferenceOutput * qmi_message_dms_set_firmware_preference_output_ref
                                                            (QmiMessageDmsSetFirmwarePreferenceOutput *self);

Atomically increments the reference count of `self` by one.

`self` : | a QmiMessageDmsSetFirmwarePreferenceOutput.
Returns : | the new reference to `self`.

### qmi_message_dms_set_firmware_preference_output_unref ()

    void                qmi_message_dms_set_firmware_preference_output_unref
                                                            (QmiMessageDmsSetFirmwarePreferenceOutput *self);

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

`self` : | a QmiMessageDmsSetFirmwarePreferenceOutput.

### qmi_message_dms_set_firmware_preference_output_get_result ()

    gboolean            qmi_message_dms_set_firmware_preference_output_get_result
                                                            (QmiMessageDmsSetFirmwarePreferenceOutput *self,
                                                             GError **error);

Get the result of the QMI operation.

`self` : | a QmiMessageDmsSetFirmwarePreferenceOutput.
`error` : | Return location for error or `NULL`.
Returns : | `TRUE` if the QMI operation succeeded, `FALSE` if `error` is set.

### qmi_message_dms_set_firmware_preference_output_get_image_download_list ()

    gboolean            qmi_message_dms_set_firmware_preference_output_get_image_download_list
                                                            (QmiMessageDmsSetFirmwarePreferenceOutput *self,
                                                             GArray **image_download_list,
                                                             GError **error);

Get the 'Image Download List' field from `self`.

`self` : | a QmiMessageDmsSetFirmwarePreferenceOutput.
`image_download_list` : | a placeholder for the output GArray of QmiDmsFirmwareImageType 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_client_dms_set_firmware_preference ()

    void                qmi_client_dms_set_firmware_preference
                                                            (QmiClientDms *self,
                                                             QmiMessageDmsSetFirmwarePreferenceInput *input,
                                                             guint timeout,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);

Asynchronously sends a Set Firmware Preference 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_dms_set_firmware_preference_finish()` to get the result of the operation.

`self` : | a QmiClientDms.
`input` : | a QmiMessageDmsSetFirmwarePreferenceInput.
`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_dms_set_firmware_preference_finish ()

    QmiMessageDmsSetFirmwarePreferenceOutput * qmi_client_dms_set_firmware_preference_finish
                                                            (QmiClientDms *self,
                                                             GAsyncResult *res,
                                                             GError **error);

Finishes an async operation started with `qmi_client_dms_set_firmware_preference()`.

`self` : | a QmiClientDms.
`res` : | the GAsyncResult obtained from the GAsyncReadyCallback passed to `qmi_client_dms_set_firmware_preference()`.
`error` : | Return location for error or `NULL`.
Returns : | a QmiMessageDmsSetFirmwarePreferenceOutput, or `NULL` if `error` is set. The returned value should be freed with `qmi_message_dms_set_firmware_preference_output_unref()`.