Unicode C

Get a Header Attribute of an Attached Message

Demonstrates the Chilkat Email.GetAttachedMessageAttr method, which returns a header-field attribute value for the Nth attached (embedded) email. The first argument is the zero-based attached-message index, the second is the header field name, and the third is the attribute name. This example attaches an email and reads the filename attribute of its Content-Disposition header.

Background: MIME header fields can carry named attributes (parameters) after the main value — for example Content-Disposition: attachment; filename="report.eml", where filename is an attribute. Rather than parsing the raw header yourself, this method extracts a single named attribute from a chosen header of a specific embedded message, which is convenient when a message forwards other emails as nested message/rfc822 parts.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkEmailW innerEmail;
    HCkEmailW email;
    const wchar_t *fname;

    success = FALSE;

    //  Demonstrates the GetAttachedMessageAttr method, which returns a header-field attribute
    //  value for the Nth attached (embedded) email.  The first argument is the zero-based
    //  attached-message index, the second is the header field name, and the third is the attribute name.

    //  Build an inner email to attach.
    innerEmail = CkEmailW_Create();
    CkEmailW_putSubject(innerEmail,L"Embedded message");
    CkEmailW_putFrom(innerEmail,L"alice@example.com");
    CkEmailW_AddTo(innerEmail,L"Bob",L"bob@example.com");

    //  Attach it to an outer email as a message/rfc822 part.
    email = CkEmailW_Create();
    CkEmailW_putSubject(email,L"Has an attached message");
    success = CkEmailW_AttachEmail(email,innerEmail);
    if (success == FALSE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkEmailW_Dispose(innerEmail);
        CkEmailW_Dispose(email);
        return true;
    }

    //  Get the "filename" attribute of the "Content-Disposition" header of the first
    //  attached message (index 0).
    fname = CkEmailW_getAttachedMessageAttr(email,0,L"Content-Disposition",L"filename");
    wprintf(L"Attached message filename attribute: %s\n",fname);


    CkEmailW_Dispose(innerEmail);
    CkEmailW_Dispose(email);

    }