Get a Header Field of a Related Item

See more Email Object Examples

Demonstrates the Chilkat Email.GetRelatedHeader method, which returns the value of a named header field of a related item. The first argument is the zero-based related-item index and the second is the MIME header-field name. This example reads the Content-Type header of a related style sheet.

Background: Each related item is a MIME part with its own header block. Where GetRelatedAttr extracts a single named parameter from a header, GetRelatedHeader returns the entire value of a header field — for example the full Content-Type or Content-Location line — which is handy for inspecting exactly how an embedded resource is described.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

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

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

    email = CkEmail_Create();
    CkEmail_putSubject(email,"GetRelatedHeader example");

    //  Set an HTML body and add a related style sheet (index 0).
    CkEmail_SetHtmlBody(email,"<html><head><link rel=\"stylesheet\" href=\"styles.css\"/></head><body>Styled.</body></html>");
    CkEmail_AddRelatedString2(email,"styles.css","body { color: navy; }","utf-8");

    //  Get the Content-Type header of the first related item (index 0).
    ct = CkEmail_getRelatedHeader(email,0,"Content-Type");
    printf("Related item 0 Content-Type: %s\n",ct);


    CkEmail_Dispose(email);

    }