Funkcijas

Funkciju pārskats

Aspose.Email FOSS for C++ nodrošina slāņotu API darbam ar Outlook MSG failiem un
Compound File Binary (CFB) konteineriem. Bibliotēkai ir 26 publiskas klases divos
apakšsistēmās: CFB un MSG/MAPI.


CFB Konteineru piekļuve

CFB apakšsistēma lasa un raksta Microsoft Compound File Binary formātu — konteineru formātu, kas ir pamatā Outlook .msg failiem.

KlaseMērķis
cfb_readerAtvērt un pārlūkot esošos CFB failus
cfb_writerSerializēt CFB dokumentus uz baitiem vai failiem
cfb_documentCFB faila atmiņā esoša pārstāve
cfb_nodeIndividuāls glabāšanas vai straumes mezgls direktoriju kokā
cfb_storageNosaukts glabāšanas ieraksts
cfb_streamNosaukta straume ar bināriem datiem

Galvenās operācijas:

  • Atvērt no faila, plūsmas vai baitiem: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
  • Uzskaitīt saturu: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
  • Navigēt pēc ceļa: find_child_by_name(), resolve_path()
  • Pārbaudīt mezglus: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
  • Rakstīt konteinerus: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

MSG faila lasīšana un rakstīšana

MSG apakšsistēma apstrādā Outlook ziņojumu formātu uz CFB pamata.

KlaseMērķis
msg_readerAtvērt un parsēt MSG failus
msg_writerSerializēt MSG dokumentus
msg_documentAtmiņā esoša MSG faila pārstāve

Galvenās operācijas:

  • Atvērt MSG failus: msg_reader::from_file(), msg_reader::from_stream()
  • Pārbaudīt metadatus: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
  • Rakstīt MSG failus: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
  • Konvertēt uz CFB: msg_document::to_cfb_document() for low-level CFB access

Augsta līmeņa MAPI ziņojuma API

Klase mapi_message nodrošina augsta līmeņa interfeisu e-pasta ziņojumu izveidei, lasīšanai un konvertēšanai.

Ziņojumu izveide:

  • mapi_message::create() — izveidot jaunu ziņojumu ar tēmu un ķermeni
  • set_subject(), set_body(), set_html_body() — iestatīt ziņojuma saturu
  • set_sender_name(), set_sender_email_address(), set_sender_address_type() — iestatīt sūtītāju
  • set_internet_message_id() — iestatīt Message-ID galveni
  • set_message_class() — iestatīt MAPI ziņojuma klasi
  • unicode_strings() / set_unicode_strings() — pārvaldīt Unicode virknes kodējumu

Ielādē ziņojumus:

  • mapi_message::from_file() — ielādēt no faila ceļa
  • mapi_message::from_stream() — ielādēt no ievades plūsmas
  • mapi_message::from_msg_document() — ielādēt no msg_document

Ziņojumu saglabāšana:

  • save() — serializēt uz baitiem, straumi vai failu
  • to_msg_document() — konvertēt uz msg_document zempakāpju piekļuvei

Pielikumi:

  • mapi_attachment::from_bytes(), mapi_attachment::from_stream() — ielādēt pievienojuma datus
  • mapi_attachment::is_embedded_message() — pārbaudīt, vai pievienojums ir iegultais MSG
  • mapi_attachment::load_data() — lēni ielādēt pievienojuma saturu

MAPI īpašības:

  • mapi_property::property_id(), property_type(), property_tag() — īpašību identificēšana
  • mapi_property::set_value(), flags(), set_flags() — īpašību manipulēšana
  • mapi_property_collection::remove() — no kolekcijas noņemt īpašības

EML un MIME konvertēšana

Pārveidot starp Outlook MSG formātu un standarta EML (RFC 5322 / MIME):

  • mapi_message::load_from_eml() — parsēt .eml failu uz mapi_message
  • mapi_message::save_to_eml() — serializēt mapi_message uz EML formātu

Temats, pamatteksts, sūtītājs, saņēmēji un pielikumi tiek saglabāti pārejas laikā.


Enumi un konstantes

EnumPurpose
common_message_property_idStandarta MAPI īpašību identifikatori (temats, pamatteksts, sūtītājs, pielikumi)
property_type_codeMAPI īpašību tipa kodi (vesels skaitlis, virkne, binārs, laiks, GUID)
msg_storage_roleGlabāšanas lomas MSG failos (ziņojums, saņēmējs, pielikums)
directory_object_typeCFB direktorija ieraksta veidi (glabāšana, plūsma, sakne)
directory_color_flagSarkan-melnā koka krāsu karogi CFB direktorija ierakstiem
sector_markerĪpašas sektoru vērtības CFB failu piešķiršanas tabulās
 Latviešu