Funkciók

Funkciók áttekintése

Az Aspose.Email FOSS for C++ rétegezett API-t biztosít az Outlook MSG fájlokkal és
Compound File Binary (CFB) tárolókkal való munkához. A könyvtár 26 nyilvános osztályt tartalmaz két alrendszerben: CFB és MSG/MAPI.


CFB konténer hozzáférés

A CFB alrendszer olvassa és írja a Microsoft Compound File Binary formátumot — az Outlook .msg fájlok alapjául szolgáló konténerformátumot.

OsztályCél
cfb_readerMegnyitja és bejárja a meglévő CFB fájlokat
cfb_writerCFB dokumentumok sorosítása bájtokba vagy fájlokba
cfb_documentMemóriában tárolt reprezentációja egy CFB fájlnak
cfb_nodeEgyedi tároló vagy adatfolyam csomópont a könyvtárfában
cfb_storageNévre hivatkozott tároló bejegyzés
cfb_streamNévre hivatkozott adatfolyam bináris adatokkal

Kulcsfontosságú műveletek:

  • Megnyitás fájlból, adatfolyamból vagy bájtokból: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
  • Tartalom felsorolása: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
  • Navigálás útvonal szerint: find_child_by_name(), resolve_path()
  • Csomópontok vizsgálata: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
  • Konténerek írása: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

MSG fájl olvasása és írása

Az MSG alrendszer a CFB tetején kezeli az Outlook üzenetformátumot.

OsztályCél
msg_readerMSG fájlok megnyitása és elemzése
msg_writerMSG dokumentumok sorosítása
msg_documentMSG fájl memóriában tárolt reprezentációja

Kulcsfontosságú műveletek:

  • MSG fájlok megnyitása: msg_reader::from_file(), msg_reader::from_stream()
  • Metaadatok ellenőrzése: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
  • MSG fájlok írása: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
  • CFB-re konvertálás: msg_document::to_cfb_document() alacsony szintű CFB hozzáféréshez

Magas szintű MAPI üzenet API

A mapi_message osztály magas szintű felületet biztosít e‑mail üzenetek létrehozásához, olvasásához és konvertálásához.

Üzenetek létrehozása:

  • mapi_message::create() — új üzenet létrehozása tárggyal és törzzsel
  • set_subject(), set_body(), set_html_body() — üzenettartalom beállítása
  • set_sender_name(), set_sender_email_address(), set_sender_address_type() — feladó beállítása
  • set_internet_message_id() — Message-ID fejléc beállítása
  • set_message_class() — MAPI üzenetosztály beállítása
  • unicode_strings() / set_unicode_strings() — Unicode karakterlánc kódolásának vezérlése

Üzenetek betöltése:

  • mapi_message::from_file() — betöltés fájl útvonalról
  • mapi_message::from_stream() — betöltés bemeneti adatfolyamból
  • mapi_message::from_msg_document() — betöltés egy msg_document-ból

Üzenetek mentése:

  • save() — sorosítás bájtokba, adatfolyamba vagy fájlba
  • to_msg_document() — konvertálás egy msg_document-re alacsony szintű hozzáféréshez

Mellékletek:

  • mapi_attachment::from_bytes(), mapi_attachment::from_stream() — csatolmány adatainak betöltése
  • mapi_attachment::is_embedded_message() — ellenőrizze, hogy a csatolmány beágyazott MSG-e
  • mapi_attachment::load_data() — a csatolmány tartalmának lusta betöltése

MAPI tulajdonságok:

  • mapi_property::property_id(), property_type(), property_tag() — tulajdonság azonosítása
  • mapi_property::set_value(), flags(), set_flags() — tulajdonság manipulálása
  • mapi_property_collection::remove() — tulajdonságok eltávolítása egy gyűjteményből

EML és MIME konverzió

Átalakítás Outlook MSG formátum és szabványos EML (RFC 5322 / MIME) között:

  • mapi_message::load_from_eml() — egy .eml fájl feldolgozása egy mapi_message-ba
  • mapi_message::save_to_eml() — egy mapi_message sorosítása EML formátumba

A tárgy, a törzs, a feladó, a címzettek és a mellékletek megmaradnak a körkörös átvitel során.


Enumok és konstansok

EnumCél
common_message_property_idStandard MAPI tulajdonságazonosítók (tárgy, törzs, feladó, mellékletek)
property_type_codeMAPI tulajdonságtípus kódok (egész, karakterlánc, bináris, idő, GUID)
msg_storage_roleTárolási szerepek MSG fájlokban (üzenet, címzett, melléklet)
directory_object_typeCFB könyvtárbejegyzés típusok (tároló, adatfolyam, gyökér)
directory_color_flagPiros‑fekete fa színjelzők a CFB könyvtárbejegyzésekhez
sector_markerSpeciális szektorértékek a CFB fájlallokációs táblákban
 Magyar