Get the Complete MIME Header of an Email

See more Email Object Examples

Demonstrates the read-only Chilkat Email.Header property, which returns the complete MIME header generated from the current in-memory email object. Because this property is read-only, you modify individual fields through their corresponding properties or header methods rather than assigning to Header directly. This example sets a subject, from, and recipient, then prints the full MIME header.

Background: A MIME email is made of two parts separated by a single blank line: the header and the body. The header is a list of Field-Name: value lines — familiar ones include From, To, Subject, and Date, plus structural fields like Content-Type and MIME-Version. Reading the raw header is useful for debugging exactly what a message will look like on the wire.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkEmail email;

    //  Demonstrates the read-only Email.Header property, which returns the
    //  complete MIME header of the email, generated from the current in-memory
    //  email object.

    email = CkEmail_Create();

    CkEmail_putSubject(email,"Test subject");
    CkEmail_putFrom(email,"mary@example.com");
    CkEmail_AddTo(email,"Joe","joe@example.com");

    //  Header is read-only.  Modify individual fields through their properties
    //  or header methods rather than assigning to Header.
    printf("%s\n",CkEmail_header(email));


    CkEmail_Dispose(email);

    }