ec_message_set_first_part

March 26, 2020 Contributors

Name

ec_message_set_first_part — Accessor function for changing the top level mime part for a message

Synopsis

#include "ec_message.h"

| void **ec_message_set_first_part** ( | mess, |   |
|   | part); |   |

ec_message * <var class="pdparam">mess</var>;
ec_message_part * <var class="pdparam">part</var>;

Description

Set or change the top level mime part for a message.

Note

You should not set mess->top directly. Rather, you should use this function so that proper accounting can occur.

Note

Does not manipulate the reference count of the part but will delete the reference to the old part.

Parameters

mess

The message. A pointer to an ec_message struct. For documentation of this data structure see “ec_message”

part

The message part. A pointer to an ec_message_part struct. For documentation of this data structure see “ec_message_part”

Return Values

This function returns void.

Threading

It is legal to call this function in any thread.

See Also

ec_message_get_first_part and ec_message_part_touch.