Funkcje

Przegląd funkcji

Aspose.Email FOSS for C++ zapewnia warstwowe API do pracy z plikami Outlook MSG oraz
kontenerami Compound File Binary (CFB). Biblioteka zawiera 26 publicznych klas w dwóch
podsystemach: CFB i MSG/MAPI.


Dostęp do kontenera CFB

Podsystem CFB odczytuje i zapisuje format Microsoft Compound File Binary — format kontenera będący podstawą plików Outlook .msg.

KlasaCel
cfb_readerOtwieranie i przeglądanie istniejących plików CFB
cfb_writerSerializacja dokumentów CFB do bajtów lub plików
cfb_documentReprezentacja pliku CFB w pamięci
cfb_nodeIndywidualny węzeł przechowywania lub strumienia w drzewie katalogów
cfb_storageNazwany wpis przechowywania
cfb_streamNazwany strumień z danymi binarnymi

Kluczowe operacje:

  • Otwórz z pliku, strumienia lub bajtów: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
  • Wylicz zawartość: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
  • Nawiguj po ścieżce: find_child_by_name(), resolve_path()
  • Sprawdź węzły: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
  • Zapisz kontenery: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

MSG Odczyt i zapis pliku

Podsystem MSG obsługuje format wiadomości Outlook na bazie CFB.

KlasaCel
msg_readerOtwieranie i analizowanie plików MSG
msg_writerSerializacja dokumentów MSG
msg_documentReprezentacja pliku MSG w pamięci

Kluczowe operacje:

  • Otwórz pliki MSG: msg_reader::from_file(), msg_reader::from_stream()
  • Sprawdź metadane: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
  • Zapisz pliki MSG: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
  • Konwertuj do CFB: msg_document::to_cfb_document() for low-level CFB access

Wysokopoziomowe API wiadomości MAPI

Klasa mapi_message zapewnia interfejs wysokiego poziomu do tworzenia, odczytywania i konwertowania wiadomości e‑mail.

Tworzenie wiadomości:

  • mapi_message::create() — utwórz nową wiadomość z tematem i treścią
  • set_subject(), set_body(), set_html_body() — ustaw treść wiadomości
  • set_sender_name(), set_sender_email_address(), set_sender_address_type() — ustaw nadawcę
  • set_internet_message_id() — ustaw nagłówek Message-ID
  • set_message_class() — ustaw klasę wiadomości MAPI
  • unicode_strings() / set_unicode_strings() — kontroluj kodowanie ciągów Unicode

Ładowanie wiadomości:

  • mapi_message::from_file() — wczytaj z ścieżki pliku
  • mapi_message::from_stream() — wczytaj ze strumienia wejściowego
  • mapi_message::from_msg_document() — wczytaj z msg_document

Zapisywanie wiadomości:

  • save() — serializować do bajtów, strumienia lub pliku
  • to_msg_document() — przekształcić w msg_document do niskopoziomowego dostępu

Załączniki:

  • mapi_attachment::from_bytes(), mapi_attachment::from_stream() — wczytaj dane załącznika
  • mapi_attachment::is_embedded_message() — sprawdź, czy załącznik jest osadzonym MSG
  • mapi_attachment::load_data() — leniwe wczytywanie zawartości załącznika

Właściwości MAPI:

  • mapi_property::property_id(), property_type(), property_tag() — identyfikacja właściwości
  • mapi_property::set_value(), flags(), set_flags() — manipulacja właściwościami
  • mapi_property_collection::remove() — usuwanie właściwości z kolekcji

Konwersja EML i MIME

Konwertuj między formatem Outlook MSG a standardowym EML (RFC 5322 / MIME):

  • mapi_message::load_from_eml() — parsować plik .eml do mapi_message
  • mapi_message::save_to_eml() — serializować mapi_message do formatu EML

Temat, treść, nadawca, odbiorcy i załączniki są zachowywane podczas wielokrotnych przetworzeń.


Wyliczenia i stałe

EnumCel
common_message_property_idStandardowe identyfikatory właściwości MAPI (temat, treść, nadawca, załączniki)
property_type_codeKody typów właściwości MAPI (liczba całkowita, ciąg znaków, binarny, czas, GUID)
msg_storage_roleRole przechowywania w plikach MSG (wiadomość, odbiorca, załącznik)
directory_object_typeTypy wpisów katalogu CFB (przechowywanie, strumień, root)
directory_color_flagFlagi koloru drzewa czerwono-czarnego dla wpisów katalogu CFB
sector_markerSpecjalne wartości sektorów w tabelach przydziału plików CFB
 Polski