C

Transition from MailMan.FetchByMsgnum to MailMan.FetchOne

Provides instructions for replacing deprecated FetchByMsgnum method calls with FetchOne. C

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

void ChilkatSample(void)
    {
    BOOL success;
    HCkMailMan mailman;
    int msgnum;
    HCkEmail emailObj;
    BOOL headerOnly;
    int numBodyLines;
    HCkEmail emailOut;

    success = FALSE;

    mailman = CkMailMan_Create();

    //  ...
    //  ...

    msgnum = 123;

    //  ------------------------------------------------------------------------
    //  The FetchByMsgnum method is deprecated:

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

    //  ...
    //  ...

    CkEmail_Dispose(emailObj);

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

    headerOnly = FALSE;
    //  Irrelevant because we are not downloading headers-only.
    numBodyLines = 0;

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



    CkMailMan_Dispose(mailman);
    CkEmail_Dispose(emailOut);

    }