C

Transition from MailMan.FetchSingleHeaderByUidl to MailMan.FetchByUidl

Provides instructions for replacing deprecated FetchSingleHeaderByUidl method calls with FetchByUidl. C

#include <C_CkMailMan.h>
#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMailMan mailman;
    int numBodyLines;
    const char *uidl;
    HCkEmail emailObj;
    BOOL headerOnly;
    HCkEmail emailOut;

    success = FALSE;

    mailman = CkMailMan_Create();

    //  ...
    //  ...

    numBodyLines = 5;
    uidl = "123";

    //  ------------------------------------------------------------------------
    //  The FetchSingleHeaderByUidl method is deprecated:

    emailObj = CkMailMan_FetchSingleHeaderByUidl(mailman,numBodyLines,uidl);
    if (CkMailMan_getLastMethodSuccess(mailman) == FALSE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkMailMan_Dispose(mailman);
        return;
    }

    //  ...
    //  ...

    CkEmail_Dispose(emailObj);

    //  ------------------------------------------------------------------------
    //  Do the equivalent using FetchByUidl.
    //  Your application creates a new, empty Email object which is passed 
    //  in the last argument and filled upon success.

    headerOnly = TRUE;

    emailOut = CkEmail_Create();
    success = CkMailMan_FetchByUidl(mailman,uidl,headerOnly,numBodyLines,emailOut);
    if (success == FALSE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkMailMan_Dispose(mailman);
        CkEmail_Dispose(emailOut);
        return;
    }



    CkMailMan_Dispose(mailman);
    CkEmail_Dispose(emailOut);

    }