Get a Header Field of an Attachment

See more Email Object Examples

Demonstrates the Chilkat Email.GetAttachmentHeader method, which returns the value of a named header field of an attachment. The first argument is the zero-based attachment index and the second is the MIME header-field name. This example reads the Content-Disposition header of the first attachment.

Background: Each attachment is a MIME part with its own header block. Where GetAttachmentAttr extracts a single named parameter, GetAttachmentHeader returns the entire value of a header field — for example the full Content-Disposition: attachment; filename="notes.txt" line. That is useful for inspecting or debugging exactly how a part is described, including any custom X- headers a sender may have added.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkEmail email;
    const char *disp;

    //  Demonstrates the GetAttachmentHeader method, which returns the value of a header field
    //  (by name) of an attachment.  The first argument is the zero-based attachment index and the second is the
    //  MIME header-field name.

    email = CkEmail_Create();
    CkEmail_putSubject(email,"Attachment header field");

    CkEmail_AddStringAttachment(email,"notes.txt","Some notes.");

    //  Get the Content-Disposition header of the first attachment (index 0).
    disp = CkEmail_getAttachmentHeader(email,0,"Content-Disposition");
    printf("Attachment 0 Content-Disposition: %s\n",disp);


    CkEmail_Dispose(email);

    }