Funkcie

Prehľad funkcií

Aspose.Email FOSS for C++ poskytuje vrstvené API pre prácu s Outlook MSG súbormi a
Compound File Binary (CFB) kontajnermi. Knižnica má 26 verejných tried v dvoch
podsystémoch: CFB a MSG/MAPI.


Prístup k CFB kontajneru

Subsystem CFB číta a zapisuje formát Microsoft Compound File Binary — kontajnerový formát, ktorý je podkladom súborov Outlook .msg.

ClassPurpose
cfb_readerOtvoriť a prechádzať existujúce CFB súbory
cfb_writerSerializovať CFB dokumenty do bajtov alebo súborov
cfb_documentReprezentácia CFB súboru v pamäti
cfb_nodeJednotlivý uzol úložiska alebo prúdu v adresárovom strome
cfb_storagePomenovaná položka úložiska
cfb_streamPomenovaný prúd s binárnymi dátami

Kľúčové operácie:

  • Otvoriť zo súboru, prúdu alebo bajtov: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
  • Vymenovať obsah: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
  • Navigovať podľa cesty: find_child_by_name(), resolve_path()
  • Preskúmať uzly: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
  • Zapísať kontajnery: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

Čítanie a zápis súboru MSG

Subsystem MSG spracováva formát správy Outlook nad CFB.

TriedaÚčel
msg_readerOtvoriť a analyzovať súbory MSG
msg_writerSerializovať dokumenty MSG
msg_documentReprezentácia MSG súboru v pamäti

Kľúčové operácie:

  • Otvoriť MSG súbory: msg_reader::from_file(), msg_reader::from_stream()
  • Skontrolovať metadáta: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
  • Zapísať MSG súbory: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
  • Konvertovať na CFB: msg_document::to_cfb_document() pre nízkoúrovňový prístup k CFB

Vysokoúrovňové MAPI Message API

Trieda mapi_message poskytuje vysokú úroveň rozhrania pre vytváranie, čítanie a konverziu e‑mailových správ.

Vytváranie správ:

  • mapi_message::create() — vytvoriť novú správu s predmetom a telom
  • set_subject(), set_body(), set_html_body() — nastaviť obsah správy
  • set_sender_name(), set_sender_email_address(), set_sender_address_type() — nastaviť odosielateľa
  • set_internet_message_id() — nastaviť hlavičku Message-ID
  • set_message_class() — nastaviť triedu MAPI správy
  • unicode_strings() / set_unicode_strings() — ovládať kódovanie Unicode reťazca

Načítava sa správy:

  • mapi_message::from_file() — načítať z cesty k súboru
  • mapi_message::from_stream() — načítať z vstupného prúdu
  • mapi_message::from_msg_document() — načítať z msg_document

Ukladanie správ:

  • save() — serializovať do bajtov, streamu alebo súboru
  • to_msg_document() — konvertovať na msg_document pre nízkoúrovňový prístup

Prílohy:

  • mapi_attachment::from_bytes(), mapi_attachment::from_stream() — načítať údaje prílohy
  • mapi_attachment::is_embedded_message() — skontrolovať, či je príloha vložený MSG
  • mapi_attachment::load_data() — načítať obsah prílohy na požiadanie

MAPI vlastnosti:

  • mapi_property::property_id(), property_type(), property_tag() — identifikácia vlastností
  • mapi_property::set_value(), flags(), set_flags() — manipulácia s vlastnosťami
  • mapi_property_collection::remove() — odstrániť vlastnosti z kolekcie

Konverzia EML a MIME

Konvertovať medzi formátom Outlook MSG a štandardným EML (RFC 5322 / MIME):

  • mapi_message::load_from_eml() — parsovať súbor .eml do mapi_message
  • mapi_message::save_to_eml() — serializovať mapi_message do formátu EML

Predmet, telo, odosielateľ, príjemcovia a prílohy zostávajú zachované počas opakovaných prechodov.


Výčty a konštanty

EnumÚčel
common_message_property_idŠtandardné identifikátory MAPI vlastností (predmet, telo, odosielateľ, prílohy)
property_type_codeKódy typov MAPI vlastností (celé číslo, reťazec, binárny, čas, GUID)
msg_storage_roleÚlohy úložiska v súboroch MSG (správa, príjemca, príloha)
directory_object_typeTypy položiek adresára CFB (úložisko, prúd, koreň)
directory_color_flagZnačky farieb červeno-čierneho stromu pre položky adresára CFB
sector_markerŠpeciálne hodnoty sektorov v tabuľkách alokácie súborov CFB
 Slovenčina