Savybės

Funkcijos apžvalga

Aspose.Email FOSS for C++ suteikia daugiapakopę API darbui su Outlook MSG failais ir Compound File Binary (CFB) konteineriais. Bibliotekoje yra 26 viešosios klasės, suskirstytos į dvi posistemos: CFB ir MSG/MAPI.


CFB konteinerio prieiga

CFB posistemė skaito ir rašo Microsoft Compound File Binary formatą — konteinerio formatą, kuris yra pagrindas Outlook .msg failams.

ClassPurpose
cfb_readerAtverti ir naršyti esamus CFB failus
cfb_writerSerializuoti CFB dokumentus į baitus arba failus
cfb_documentAtminties atvaizdavimas CFB failui
cfb_nodeIndividualus saugojimo arba srauto mazgas katalogų medyje
cfb_storagePavadintas saugojimo įrašas
cfb_streamPavadintas srautas su binariniais duomenimis

Pagrindinės operacijos:

  • Atidaryti iš failo, srauto arba baitų: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
  • Išvardyti turinį: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
  • Naršyti pagal kelią: find_child_by_name(), resolve_path()
  • Patikrinti mazgus: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
  • Rašyti konteinerius: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

MSG failo skaitymas ir rašymas

MSG posistemė apdoroja Outlook pranešimų formatą ant CFB.

KlasėTikslas
msg_readerAtidaryti ir analizuoti MSG failus
msg_writerSerializuoti MSG dokumentus
msg_documentAtmintyje saugoma MSG failo reprezentacija

Pagrindinės operacijos:

  • Atidaryti MSG failus: msg_reader::from_file(), msg_reader::from_stream()
  • Patikrinti metaduomenis: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
  • Rašyti MSG failus: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
  • Konvertuoti į CFB: msg_document::to_cfb_document() žemų lygių CFB prieigai

Aukšto lygio MAPI žinučių API

mapi_message klasė suteikia aukšto lygio sąsają kuriant, skaitant ir konvertuojant el. laiškų pranešimus.

Kuriant pranešimus:

  • mapi_message::create() — sukurti naują laišką su tema ir turiniu
  • set_subject(), set_body(), set_html_body() — nustatyti pranešimo turinį
  • set_sender_name(), set_sender_email_address(), set_sender_address_type() — nustatyti siuntėją
  • set_internet_message_id() — nustatyti Message-ID antraštę
  • set_message_class() — nustatyti MAPI pranešimo klasę
  • unicode_strings() / set_unicode_strings() — valdyti Unicode eilutės kodavimą

Įkeliami pranešimai:

  • mapi_message::from_file() — įkelti iš failo kelio
  • mapi_message::from_stream() — įkelti iš įvesties srauto
  • mapi_message::from_msg_document() — įkelti iš msg_document

Išsaugomi pranešimai:

  • save() — serializuoti į baitus, srautą arba failą
  • to_msg_document() — konvertuoti į msg_document, kad būtų galimas žemo lygio priėjimas

Priedai:

  • mapi_attachment::from_bytes(), mapi_attachment::from_stream() — įkelti priedo duomenis
  • mapi_attachment::is_embedded_message() — patikrinti, ar priedas yra įterptas MSG
  • mapi_attachment::load_data() — pakrauti priedo turinį pagal poreikį

MAPI savybės:

  • mapi_property::property_id(), property_type(), property_tag() — savybių identifikavimas
  • mapi_property::set_value(), flags(), set_flags() — savybių manipuliavimas
  • mapi_property_collection::remove() — pašalinti savybes iš kolekcijos

EML ir MIME konvertavimas

Konvertuoti tarp Outlook MSG formato ir standartinio EML (RFC 5322 / MIME):

  • mapi_message::load_from_eml() — išanalizuoti .eml failą į mapi_message
  • mapi_message::save_to_eml() — serializuoti mapi_message į EML formatą

Tema, turinys, siuntėjas, gavėjai ir priedai išlieka nepakitę per kelis perkelimus.


Enumai ir konstantos

EnumTikslas
common_message_property_idStandartiniai MAPI savybių identifikatoriai (tema, turinys, siuntėjas, priedai)
property_type_codeMAPI savybių tipų kodai (sveikasis skaičius, tekstas, dvejetainis, laikas, GUID)
msg_storage_roleSaugojimo vaidmenys MSG failuose (žinutė, gavėjas, priedas)
directory_object_typeCFB katalogo įrašo tipai (saugykla, srautas, šaknis)
directory_color_flagRaudono-juodo medžio spalvų vėliavos CFB katalogo įrašams
sector_markerSpecialios sektoriaus reikšmės CFB failų paskirstymo lentelėse
 Lietuvių