## DMS Get Firmware Preference DMS Get Firmware Preference |

## Synopsis

                        QmiMessageDmsGetFirmwarePreferenceOutput;
                        QmiMessageDmsGetFirmwarePreferenceOutputListImage;

    QmiMessageDmsGetFirmwarePreferenceOutput * qmi_message_dms_get_firmware_preference_output_ref
                                                            (QmiMessageDmsGetFirmwarePreferenceOutput *self);
    void                qmi_message_dms_get_firmware_preference_output_unref
                                                            (QmiMessageDmsGetFirmwarePreferenceOutput *self);
    gboolean            qmi_message_dms_get_firmware_preference_output_get_result
                                                            (QmiMessageDmsGetFirmwarePreferenceOutput *self,
                                                             GError **error);
    gboolean            qmi_message_dms_get_firmware_preference_output_get_list
                                                            (QmiMessageDmsGetFirmwarePreferenceOutput *self,
                                                             GArray **list,
                                                             GError **error);

    void                qmi_client_dms_get_firmware_preference
                                                            (QmiClientDms *self,
                                                             gpointer unused,
                                                             guint timeout,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    QmiMessageDmsGetFirmwarePreferenceOutput * qmi_client_dms_get_firmware_preference_finish
                                                            (QmiClientDms *self,
                                                             GAsyncResult *res,
                                                             GError **error);

## Object Hierarchy

      GBoxed
       +----QmiMessageDmsGetFirmwarePreferenceOutput

## Description

## Details

### QmiMessageDmsGetFirmwarePreferenceOutput

    typedef struct _QmiMessageDmsGetFirmwarePreferenceOutput QmiMessageDmsGetFirmwarePreferenceOutput;

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

### QmiMessageDmsGetFirmwarePreferenceOutputListImage

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

A QmiMessageDmsGetFirmwarePreferenceOutputListImage struct.

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

### qmi_message_dms_get_firmware_preference_output_ref ()

    QmiMessageDmsGetFirmwarePreferenceOutput * qmi_message_dms_get_firmware_preference_output_ref
                                                            (QmiMessageDmsGetFirmwarePreferenceOutput *self);

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

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

### qmi_message_dms_get_firmware_preference_output_unref ()

    void                qmi_message_dms_get_firmware_preference_output_unref
                                                            (QmiMessageDmsGetFirmwarePreferenceOutput *self);

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

`self` : | a QmiMessageDmsGetFirmwarePreferenceOutput.

### qmi_message_dms_get_firmware_preference_output_get_result ()

    gboolean            qmi_message_dms_get_firmware_preference_output_get_result
                                                            (QmiMessageDmsGetFirmwarePreferenceOutput *self,
                                                             GError **error);

Get the result of the QMI operation.

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

### qmi_message_dms_get_firmware_preference_output_get_list ()

    gboolean            qmi_message_dms_get_firmware_preference_output_get_list
                                                            (QmiMessageDmsGetFirmwarePreferenceOutput *self,
                                                             GArray **list,
                                                             GError **error);

Get the 'List' field from `self`.

`self` : | a QmiMessageDmsGetFirmwarePreferenceOutput.
`list` : | a placeholder for the output GArray of QmiMessageDmsGetFirmwarePreferenceOutputListImage 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_get_firmware_preference ()

    void                qmi_client_dms_get_firmware_preference
                                                            (QmiClientDms *self,
                                                             gpointer unused,
                                                             guint timeout,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);

Asynchronously sends a Get 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_get_firmware_preference_finish()` to get the result of the operation.

`self` : | a QmiClientDms.
`unused` : | `NULL`. This message doesn't have any input bundle.
`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_get_firmware_preference_finish ()

    QmiMessageDmsGetFirmwarePreferenceOutput * qmi_client_dms_get_firmware_preference_finish
                                                            (QmiClientDms *self,
                                                             GAsyncResult *res,
                                                             GError **error);

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

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