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.
| Class | Purpose |
|---|---|
cfb_reader | Otvoriť a prechádzať existujúce CFB súbory |
cfb_writer | Serializovať CFB dokumenty do bajtov alebo súborov |
cfb_document | Reprezentácia CFB súboru v pamäti |
cfb_node | Jednotlivý uzol úložiska alebo prúdu v adresárovom strome |
cfb_storage | Pomenovaná položka úložiska |
cfb_stream | Pomenovaný 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_reader | Otvoriť a analyzovať súbory MSG |
msg_writer | Serializovať dokumenty MSG |
msg_document | Reprezentá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 telomset_subject(),set_body(),set_html_body()— nastaviť obsah správyset_sender_name(),set_sender_email_address(),set_sender_address_type()— nastaviť odosielateľaset_internet_message_id()— nastaviť hlavičku Message-IDset_message_class()— nastaviť triedu MAPI správyunicode_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úborumapi_message::from_stream()— načítať z vstupného prúdumapi_message::from_msg_document()— načítať zmsg_document
Ukladanie správ:
save()— serializovať do bajtov, streamu alebo súboruto_msg_document()— konvertovať namsg_documentpre nízkoúrovňový prístup
Prílohy:
mapi_attachment::from_bytes(),mapi_attachment::from_stream()— načítať údaje prílohymapi_attachment::is_embedded_message()— skontrolovať, či je príloha vložený MSGmapi_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ťamimapi_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.emldomapi_messagemapi_message::save_to_eml()— serializovaťmapi_messagedo 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_code | Kó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_type | Typy položiek adresára CFB (úložisko, prúd, koreň) |
directory_color_flag | Znač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 |