ec_message_get_first_part

March 26, 2020 Contributors

Name

ec_message_get_first_part — Returns the top level mime part of the message

Synopsis

#include "ec_message.h"

| ec_message_part * **ec_message_get_first_part** ( | mess, |   |
|   | headers_only); |   |

ec_message * <var class="pdparam">mess</var>;
int <var class="pdparam">headers_only</var>;

Description

Returns the top level mime part of the message. This may result in a just-in-time message parse if we haven’t already done one. Does not manipulate the reference count of the message part.

Parameters

mess

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

headers_only

An integer value. If headers_only = 1, then there will not be a message reparse. If headers_only = 0, reparsing the message may be required.

Return Values

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

Threading

It is legal to call this function in any thread.

See Also

ec_message_set_first_part and ec_message_part_touch.