Funkce

Přehled funkce

Aspose.Email FOSS for C++ poskytuje vrstvené API pro práci se soubory Outlook MSG a kontejnery Compound File Binary (CFB). Knihovna má 26 veřejných tříd napříč dvěma subsystémy: CFB a MSG/MAPI.


Přístup k CFB kontejneru

Subsystem CFB čte a zapisuje formát Microsoft Compound File Binary — kontejnerový formát, který je základem souborů Outlook .msg.

ClassPurpose
cfb_readerOtevřít a procházet existující soubory CFB
cfb_writerSerializovat dokumenty CFB do bajtů nebo souborů
cfb_documentPaměťová reprezentace souboru CFB
cfb_nodeJednotlivý uzel úložiště nebo proudu v adresářovém stromu
cfb_storagePojmenovaná položka úložiště
cfb_streamPojmenovaný proud s binárními daty

Klíčové operace:

  • Otevřít ze souboru, proudu nebo bajtů: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
  • Enumerovat obsah: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
  • Navigovat podle cesty: find_child_by_name(), resolve_path()
  • Prozkoumat uzly: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
  • Zapsat kontejnery: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

MSG File čtení a zápis

Subsystem MSG zpracovává formát zpráv Outlook nad CFB.

TřídaÚčel
msg_readerOtevřít a analyzovat soubory MSG
msg_writerSerializovat dokumenty MSG
msg_documentPaměťová reprezentace souboru MSG

Klíčové operace:

  • Otevřít soubory MSG: msg_reader::from_file(), msg_reader::from_stream()
  • Prozkoumat metadata: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
  • Zapsat soubory MSG: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
  • Převést na CFB: msg_document::to_cfb_document() for low-level CFB access

Vysoce úrovňové MAPI API zpráv

Třída mapi_message poskytuje vysoceúrovňové rozhraní pro vytváření, čtení a konverzi e‑mailových zpráv.

Vytváření zpráv:

  • mapi_message::create() — vytvořit novou zprávu s předmětem a tělem
  • set_subject(), set_body(), set_html_body() — nastavit obsah zprávy
  • set_sender_name(), set_sender_email_address(), set_sender_address_type() — nastavit odesílatele
  • set_internet_message_id() — nastavit hlavičku Message-ID
  • set_message_class() — nastavit třídu MAPI zprávy
  • unicode_strings() / set_unicode_strings() — ovládat kódování Unicode řetězce

Načítání zpráv:

  • mapi_message::from_file() — načíst ze souborové cesty
  • mapi_message::from_stream() — načíst ze vstupního proudu
  • mapi_message::from_msg_document() — načíst z msg_document

Ukládání zpráv:

  • save() — serializovat do bajtů, proudu nebo souboru
  • to_msg_document() — převést na msg_document pro nízkoúrovňový přístup

Přílohy:

  • mapi_attachment::from_bytes(), mapi_attachment::from_stream() — načíst data přílohy
  • mapi_attachment::is_embedded_message() — zkontrolovat, zda je příloha vložený MSG
  • mapi_attachment::load_data() — líně načíst obsah přílohy

Vlastnosti MAPI:

  • mapi_property::property_id(), property_type(), property_tag() — identifikace vlastností
  • mapi_property::set_value(), flags(), set_flags() — manipulace s vlastnostmi
  • mapi_property_collection::remove() — odstranění vlastností ze sbírky

EML a konverze MIME

Převod mezi formátem Outlook MSG a standardním EML (RFC 5322 / MIME):

  • mapi_message::load_from_eml() — parsovat soubor .eml do mapi_message
  • mapi_message::save_to_eml() — serializovat mapi_message do formátu EML

Předmět, tělo, odesílatel, příjemci a přílohy jsou zachovány při opakovaných přenosech.


Výčty a konstanty

EnumÚčel
common_message_property_idStandardní identifikátory vlastností MAPI (předmět, tělo, odesílatel, přílohy)
property_type_codeKódy typů vlastností MAPI (celé číslo, řetězec, binární, čas, GUID)
msg_storage_roleÚložištní role v souborech MSG (zpráva, příjemce, příloha)
directory_object_typeTypy položek adresáře CFB (úložiště, proud, kořen)
directory_color_flagBarevné příznaky červeno-černého stromu pro položky adresáře CFB
sector_markerSpeciální hodnoty sektorů v alokačních tabulkách souborů CFB
 Čeština