Ciri-ciri

Gambaran Keseluruhan Ciri

Aspose.Email FOSS for C++ menyediakan API berlapis untuk bekerja dengan fail Outlook MSG dan kontena Compound File Binary (CFB). Perpustakaan ini mempunyai 26 kelas awam merentasi dua subsystem: CFB dan MSG/MAPI.


Akses Kontena CFB

Subsystem CFB membaca dan menulis format Microsoft Compound File Binary — format kontena yang menjadi asas fail Outlook .msg.

KelasTujuan
cfb_readerBuka dan lalui fail CFB sedia ada
cfb_writerSerialkan dokumen CFB kepada bait atau fail
cfb_documentRepresentasi dalam memori bagi fail CFB
cfb_nodeNode storan atau aliran individu dalam pokok direktori
cfb_storageEntri storan bernama
cfb_streamAliran bernama dengan data binari

Operasi utama:

  • Buka dari fail, aliran, atau bait: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
  • Senaraikan kandungan: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
  • Navigasi mengikut laluan: find_child_by_name(), resolve_path()
  • Periksa nod: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
  • Tulis kontena: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

MSG Baca dan Tulis Fail

Subsystem MSG mengendalikan format mesej Outlook di atas CFB.

ClassPurpose
msg_readerBuka dan hurai fail MSG
msg_writerSerialkan dokumen MSG
msg_documentRepresentasi dalam memori bagi fail MSG

Operasi utama:

  • Buka fail MSG: msg_reader::from_file(), msg_reader::from_stream()
  • Periksa metadata: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
  • Tulis fail MSG: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
  • Tukar ke CFB: msg_document::to_cfb_document() untuk akses CFB peringkat rendah

API Mesej MAPI Tahap Tinggi

Kelas mapi_message menyediakan antara muka peringkat tinggi untuk membuat, membaca, dan menukar mesej e‑mel.

Mencipta mesej:

  • mapi_message::create() — bina mesej baru dengan subjek dan badan
  • set_subject(), set_body(), set_html_body() — tetapkan kandungan mesej
  • set_sender_name(), set_sender_email_address(), set_sender_address_type() — tetapkan penghantar
  • set_internet_message_id() — tetapkan pengepala Message-ID
  • set_message_class() — tetapkan kelas mesej MAPI
  • unicode_strings() / set_unicode_strings() — kendalikan pengekodan rentetan Unicode

Memuatkan mesej:

  • mapi_message::from_file() — muat dari laluan fail
  • mapi_message::from_stream() — muat dari aliran input
  • mapi_message::from_msg_document() — muat dari msg_document

Menyimpan mesej:

  • save() — siri ke bait, aliran, atau fail
  • to_msg_document() — tukar kepada msg_document untuk akses aras rendah

Lampiran:

  • mapi_attachment::from_bytes(), mapi_attachment::from_stream() — memuat data lampiran
  • mapi_attachment::is_embedded_message() — memeriksa sama ada lampiran adalah MSG terbenam
  • mapi_attachment::load_data() — memuat kandungan lampiran secara malas

ciri MAPI:

  • mapi_property::property_id(), property_type(), property_tag() — pengenalpastian sifat
  • mapi_property::set_value(), flags(), set_flags() — manipulasi sifat
  • mapi_property_collection::remove() — buang sifat dari koleksi

Penukaran EML dan MIME

Tukar antara format Outlook MSG dan EML standard (RFC 5322 / MIME):

  • mapi_message::load_from_eml() — parse sebuah fail .eml ke dalam mapi_message
  • mapi_message::save_to_eml() — serialize sebuah mapi_message ke format EML

Subjek, badan, penghantar, penerima, dan lampiran dipelihara melalui perjalanan pusingan.


Enum dan Konstanta

EnumTujuan
common_message_property_idPengenal sifat MAPI standard (subjek, badan, penghantar, lampiran)
property_type_codeKod jenis sifat MAPI (integer, string, binari, masa, GUID)
msg_storage_rolePeranan storan dalam fail MSG (mesej, penerima, lampiran)
directory_object_typeJenis entri direktori CFB (storan, aliran, akar)
directory_color_flagBendera warna pokok merah‑hitam untuk entri direktori CFB
sector_markerNilai sektor khas dalam jadual peruntukan fail CFB
 Bahasa Melayu