Ominaisuudet

Ominaisuuksien yleiskatsaus

Aspose.Email FOSS for C++ tarjoaa kerrostetun API:n Outlook MSG -tiedostojen ja Compound File Binary (CFB) -konttien kanssa työskentelemiseen. Kirjastossa on 26 julkista luokkaa kahdessa alijärjestelmässä: CFB ja MSG/MAPI.


CFB-säiliön pääsy

CFB-alijärjestelmä lukee ja kirjoittaa Microsoftin Compound File Binary -formaattia — Outlook .msg -tiedostojen taustalla oleva säiliöformaatti.

LuokkaTarkoitus
cfb_readerAvaa ja selaa olemassa olevia CFB-tiedostoja
cfb_writerSarjoita CFB-dokumentit tavuiksi tai tiedostoiksi
cfb_documentMuistissa oleva esitys CFB-tiedostosta
cfb_nodeYksittäinen tallennus- tai virta-solmu hakemistopuussa
cfb_storageNimetty tallennusmerkintä
cfb_streamNimetty virta, jossa on binääridataa

Keskeiset toiminnot:

  • Avaa tiedostosta, virtauksesta tai tavuista: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
  • Luettele sisällöt: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
  • Navigoi polun avulla: find_child_by_name(), resolve_path()
  • Tutki solmuja: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
  • Kirjoita säiliöt: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

MSG-tiedoston lukeminen ja kirjoittaminen

MSG-alijärjestelmä käsittelee Outlook-viestimuotoa CFB:n päällä.

LuokkaTarkoitus
msg_readerAvaa ja jäsennä MSG‑tiedostot
msg_writerSarjoita MSG‑dokumentit
msg_documentMuistissa oleva esitys MSG‑tiedostosta

Keskeiset toiminnot:

  • Avaa MSG-tiedostot: msg_reader::from_file(), msg_reader::from_stream()
  • Tarkastele metatietoja: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
  • Kirjoita MSG-tiedostoja: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
  • Muunna CFB-muotoon: msg_document::to_cfb_document() alhaisen tason CFB-pääsyä varten

Korkean tason MAPI-viesti-API

mapi_message-luokka tarjoaa korkean tason käyttöliittymän sähköpostiviestien luomiseen, lukemiseen ja muuntamiseen.

Viestien luominen:

  • mapi_message::create() — luo uusi viesti, jossa on aihe ja runko
  • set_subject(), set_body(), set_html_body() — aseta viestin sisältö
  • set_sender_name(), set_sender_email_address(), set_sender_address_type() — aseta lähettäjä
  • set_internet_message_id() — aseta Message-ID-otsake
  • set_message_class() — aseta MAPI-viestiluokka
  • unicode_strings() / set_unicode_strings() — ohjaa Unicode-merkkijonon koodausta

Ladataan viestejä:

  • mapi_message::from_file() — lataa tiedostopolusta
  • mapi_message::from_stream() — lataa syötevirrasta
  • mapi_message::from_msg_document() — lataa msg_document:stä

Tallennetaan viestejä:

  • save() — sarjoittaa tavuiksi, virtaan tai tiedostoon
  • to_msg_document() — muuntaa msg_document:ksi alhaisen tason käyttöä varten

Liitteet:

  • mapi_attachment::from_bytes(), mapi_attachment::from_stream() — lataa liitetiedot
  • mapi_attachment::is_embedded_message() — tarkista, onko liite upotettu MSG
  • mapi_attachment::load_data() — lataa liitteen sisältö viiveellä

MAPI-ominaisuudet:

  • mapi_property::property_id(), property_type(), property_tag() — ominaisuuksien tunnistus
  • mapi_property::set_value(), flags(), set_flags() — ominaisuuksien käsittely
  • mapi_property_collection::remove() — poista ominaisuuksia kokoelmasta

EML ja MIME-muunnos

Muunna Outlook MSG -muoto ja standardi EML (RFC 5322 / MIME) välillä:

  • mapi_message::load_from_eml() — jäsentää .eml-tiedoston mapi_messageksi
  • mapi_message::save_to_eml() — sarjoittaa mapi_message EML-muotoon

Aihe, viestin runko, lähettäjä, vastaanottajat ja liitteet säilyvät läpikulkujen aikana.


Enumit ja vakioarvot

EnumTarkoitus
common_message_property_idStandardi MAPI-ominaisuustunnisteet (aihe, runko, lähettäjä, liitteet)
property_type_codeMAPI-ominaisuustyyppikoodit (kokonaisluku, merkkijono, binaari, aika, GUID)
msg_storage_roleTallennusroolit MSG-tiedostoissa (viesti, vastaanottaja, liite)
directory_object_typeCFB-hakemistomerkinnän tyypit (tallennus, virta, juuri)
directory_color_flagPunamustapuun väri liput CFB-hakemistomerkinnöille
sector_markerErityiset sektoriarvot CFB-tiedoston allokointitauluissa
 Suomi