Camel.MessageInfo.take_user_tags

### Method

# Camel MessageInfotake_user_tags

since: 3.24

#### Declaration [src]

    gboolean
    camel_message_info_take_user_tags (
      CamelMessageInfo* mi,
      CamelNameValueArray* user_tags
    )

#### Description [src]

Takes all the `user_tags`, which replaces any current user tags on the `mi`. The passed-in `user_tags` is consumed by the `mi`, which becomes an owner of it. The caller should not change `user_tags` afterwards.

If the `mi` changed, the ‘dirty’ flag and the ‘folder-flagged’ flag are set automatically, unless the `mi` is aborting notifications. There is also emitted folder’s “changed” signal for this `mi`, if necessary.

Note that it’s not safe to use the `user_tags` after the call to this function, because it can be freed due to no change.

Available since: 3.24

#### Parameters

`user_tags`

  Type: `CamelNameValueArray`

  User tags to set.

  The argument can be `NULL`.
  The instance takes ownership of the data, and is responsible for freeing it.

#### Return value

Type: `gboolean`

Whether the `mi` changed.