Count the Report Parts in a multipart/report Email

See more Email Object Examples

Demonstrates the read-only Chilkat Email.NumReports property, which is the number of report parts in a multipart/report email. A part is counted as a report when its Content-Type is message/* (except message/rfc822) or text/rfc822-headers. Use GetReport to retrieve the body of each report part; indexes are zero-based. This example loads a report email and prints each report part.

Background: When a message can't be delivered, the mail system usually sends back a bounce known as a Delivery Status Notification (DSN). DSNs use the multipart/report structure, which bundles several parts: a human-readable explanation, a machine-readable message/delivery-status part describing exactly what happened (recipient, status code, failing server), and often the original message's headers. Reading these report parts lets a program automatically detect and process bounces.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkEmail email;
    int n;
    int i;

    success = FALSE;

    //  Demonstrates the read-only Email.NumReports property, which is the number of report
    //  parts in a multipart/report email (for example, a Delivery Status Notification).
    //  Use GetReport to retrieve the body of each report part.  Indexes are zero-based.

    email = CkEmail_Create();

    //  Load a multipart/report email (such as a bounce / DSN message).
    success = CkEmail_LoadEml(email,"qa_data/eml/dsn_bounce.eml");
    if (success == FALSE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkEmail_Dispose(email);
        return;
    }

    n = CkEmail_getNumReports(email);
    printf("NumReports = %d\n",n);

    for (i = 0; i <= n - 1; i++) {
        printf("---- Report %d ----\n",i);
        printf("%s\n",CkEmail_getReport(email,i));
    }



    CkEmail_Dispose(email);

    }