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.
| Class | Purpose |
|---|---|
cfb_reader | Otevřít a procházet existující soubory CFB |
cfb_writer | Serializovat dokumenty CFB do bajtů nebo souborů |
cfb_document | Paměťová reprezentace souboru CFB |
cfb_node | Jednotlivý uzel úložiště nebo proudu v adresářovém stromu |
cfb_storage | Pojmenovaná položka úložiště |
cfb_stream | Pojmenovaný 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_reader | Otevřít a analyzovat soubory MSG |
msg_writer | Serializovat dokumenty MSG |
msg_document | Paměť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ělemset_subject(),set_body(),set_html_body()— nastavit obsah zprávyset_sender_name(),set_sender_email_address(),set_sender_address_type()— nastavit odesílateleset_internet_message_id()— nastavit hlavičku Message-IDset_message_class()— nastavit třídu MAPI zprávyunicode_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é cestymapi_message::from_stream()— načíst ze vstupního proudumapi_message::from_msg_document()— načíst zmsg_document
Ukládání zpráv:
save()— serializovat do bajtů, proudu nebo souboruto_msg_document()— převést namsg_documentpro nízkoúrovňový přístup
Přílohy:
mapi_attachment::from_bytes(),mapi_attachment::from_stream()— načíst data přílohymapi_attachment::is_embedded_message()— zkontrolovat, zda je příloha vložený MSGmapi_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 vlastnostmimapi_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.emldomapi_messagemapi_message::save_to_eml()— serializovatmapi_messagedo 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_id | Standardní identifikátory vlastností MAPI (předmět, tělo, odesílatel, přílohy) |
property_type_code | Kó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_type | Typy položek adresáře CFB (úložiště, proud, kořen) |
directory_color_flag | Barevné příznaky červeno-černého stromu pro položky adresáře CFB |
sector_marker | Speciální hodnoty sektorů v alokačních tabulkách souborů CFB |