(PureBasic) Transition from MailMan.GetFullEmail to MailMan.FetchFull

Provides instructions for replacing deprecated GetFullEmail method calls with FetchFull.

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkEmail.pb"
IncludeFile "CkMailMan.pb"

Procedure ChilkatExample()

    mailman.i = CkMailMan::ckCreate()
    If mailman.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; ...
    ; ...

    ; Assume the email header was previously downloaded using some other Chilkat method...
    emailHeader.i = CkEmail::ckCreate()
    If emailHeader.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; ------------------------------------------------------------------------
    ; The GetFullEmail method is deprecated:

    fullEmailObj.i = CkMailMan::ckGetFullEmail(mailman,emailHeader)
    If CkMailMan::ckLastMethodSuccess(mailman) = 0
        Debug CkMailMan::ckLastErrorText(mailman)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(emailHeader)
        ProcedureReturn
    EndIf

    ; ...
    ; ...

    CkEmail::ckDispose(fullEmailObj)

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

    fullEmail.i = CkEmail::ckCreate()
    If fullEmail.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success.i = CkMailMan::ckFetchFull(mailman,emailHeader,fullEmail)
    If success = 0
        Debug CkMailMan::ckLastErrorText(mailman)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(emailHeader)
        CkEmail::ckDispose(fullEmail)
        ProcedureReturn
    EndIf



    CkMailMan::ckDispose(mailman)
    CkEmail::ckDispose(emailHeader)
    CkEmail::ckDispose(fullEmail)


    ProcedureReturn
EndProcedure