PureBasic

Get a Header Field of an Attachment

Demonstrates the Chilkat Email.GetAttachmentHeader method, which returns the value of a named header field of an attachment. The first argument is the zero-based attachment index and the second is the MIME header-field name. This example reads the Content-Disposition header of the first attachment.

Background: Each attachment is a MIME part with its own header block. Where GetAttachmentAttr extracts a single named parameter, GetAttachmentHeader returns the entire value of a header field — for example the full Content-Disposition: attachment; filename="notes.txt" line. That is useful for inspecting or debugging exactly how a part is described, including any custom X- headers a sender may have added.

Chilkat PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

    ;  Demonstrates the GetAttachmentHeader method, which returns the value of a header field
    ;  (by name) of an attachment.  The first argument is the zero-based attachment index and the second is the
    ;  MIME header-field name.

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

    CkEmail::setCkSubject(email, "Attachment header field")

    CkEmail::ckAddStringAttachment(email,"notes.txt","Some notes.")

    ;  Get the Content-Disposition header of the first attachment (index 0).
    disp.s = CkEmail::ckGetAttachmentHeader(email,0,"Content-Disposition")
    Debug "Attachment 0 Content-Disposition: " + disp


    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure