Unicode C

Save a Related Item to Disk

Demonstrates the Chilkat Email.SaveRelatedItem method, which saves the related item at a given zero-based index to a directory. If the directory or any of its components do not exist, Chilkat creates them. This example adds a related style sheet and saves it.

Background: Related items are the inline resources (images, style sheets) an HTML email carries in its multipart/related enclosure. SaveRelatedItem writes one of them out as a file — a building block for tasks like extracting a specific embedded image, or manually unpacking a message when you want finer control than the all-in-one UnpackHtml / AspUnpack methods provide.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkEmailW email;

    success = FALSE;

    //  Demonstrates the SaveRelatedItem method, which saves the related item at a given
    //  zero-based index to a directory.  If the directory (or any of its components) does not
    //  exist, Chilkat creates it.

    email = CkEmailW_Create();
    CkEmailW_putSubject(email,L"Save a related item");

    //  Set an HTML body that references a related style sheet by name.
    CkEmailW_SetHtmlBody(email,L"<html><head><link rel=\"stylesheet\" href=\"styles.css\"/></head><body>Styled.</body></html>");
    CkEmailW_AddRelatedString2(email,L"styles.css",L"body { color: navy; }",L"utf-8");

    //  Save the related item at index 0 into the specified directory.
    success = CkEmailW_SaveRelatedItem(email,0,L"qa_output/related");
    if (success == FALSE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkEmailW_Dispose(email);
        return true;
    }

    wprintf(L"Saved related item 0.\n");

    //  Note: The path "qa_output/..." is a relative local filesystem path,
    //  relative to the current working directory of the running application.


    CkEmailW_Dispose(email);

    }