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.
| Klase | Mērķis |
|---|---|
cfb_reader | Atvērt un pārlūkot esošos CFB failus |
cfb_writer | Serializēt CFB dokumentus uz baitiem vai failiem |
cfb_document | CFB faila atmiņā esoša pārstāve |
cfb_node | Individuāls glabāšanas vai straumes mezgls direktoriju kokā |
cfb_storage | Nosaukts glabāšanas ieraksts |
cfb_stream | Nosaukta 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.
| Klase | Mērķis |
|---|---|
msg_reader | Atvērt un parsēt MSG failus |
msg_writer | Serializēt MSG dokumentus |
msg_document | Atmiņā 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 ķermeniset_subject(),set_body(),set_html_body()— iestatīt ziņojuma saturuset_sender_name(),set_sender_email_address(),set_sender_address_type()— iestatīt sūtītājuset_internet_message_id()— iestatīt Message-ID galveniset_message_class()— iestatīt MAPI ziņojuma klasiunicode_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ļamapi_message::from_stream()— ielādēt no ievades plūsmasmapi_message::from_msg_document()— ielādēt nomsg_document
Ziņojumu saglabāšana:
save()— serializēt uz baitiem, straumi vai failuto_msg_document()— konvertēt uzmsg_documentzempakāpju piekļuvei
Pielikumi:
mapi_attachment::from_bytes(),mapi_attachment::from_stream()— ielādēt pievienojuma datusmapi_attachment::is_embedded_message()— pārbaudīt, vai pievienojums ir iegultais MSGmapi_attachment::load_data()— lēni ielādēt pievienojuma saturu
MAPI īpašības:
mapi_property::property_id(),property_type(),property_tag()— īpašību identificēšanamapi_property::set_value(),flags(),set_flags()— īpašību manipulēšanamapi_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.emlfailu uzmapi_messagemapi_message::save_to_eml()— serializētmapi_messageuz EML formātu
Temats, pamatteksts, sūtītājs, saņēmēji un pielikumi tiek saglabāti pārejas laikā.
Enumi un konstantes
| Enum | Purpose |
|---|---|
common_message_property_id | Standarta MAPI īpašību identifikatori (temats, pamatteksts, sūtītājs, pielikumi) |
property_type_code | MAPI īpašību tipa kodi (vesels skaitlis, virkne, binārs, laiks, GUID) |
msg_storage_role | Glabāšanas lomas MSG failos (ziņojums, saņēmējs, pielikums) |
directory_object_type | CFB direktorija ieraksta veidi (glabāšana, plūsma, sakne) |
directory_color_flag | Sarkan-melnā koka krāsu karogi CFB direktorija ierakstiem |
sector_marker | Īpašas sektoru vērtības CFB failu piešķiršanas tabulās |