Unicode C

Get a Header Attribute of an Attachment

Demonstrates the Chilkat Email.GetAttachmentAttr method, which returns a header-field attribute value from a header field of the Nth attachment. The first argument is the zero-based attachment index, the second names a header field, and the third names an attribute within it. This example reads the filename attribute of the attachment's Content-Disposition header.

Background: A MIME header can have named parameters after its main value, such as Content-Type: text/plain; charset="utf-8"; name="notes.txt". Here charset and name are attributes. GetAttachmentAttr pulls out one named attribute from a chosen header of a specific attachment, sparing you from parsing the raw header string and dealing with quoting or ordering.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

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

    //  Demonstrates the GetAttachmentAttr method, which returns a header-field attribute value
    //  from a header field of the Nth attachment.  The first argument is the zero-based attachment
    //  index, the second is the header field name, and the third is the attribute name.

    email = CkEmailW_Create();
    CkEmailW_putSubject(email,L"Attachment header attribute");

    CkEmailW_AddStringAttachment(email,L"notes.txt",L"Some notes.");

    //  Get the "filename" attribute of the attachment's Content-Disposition header (index 0).
    fname = CkEmailW_getAttachmentAttr(email,0,L"Content-Disposition",L"filename");
    wprintf(L"Attachment filename attribute: %s\n",fname);


    CkEmailW_Dispose(email);

    }