Aspose.Email FOSS للـ C++
قراءة وإنشاء ومعالجة ملفات Outlook MSG وحاويات CFB من C++ — مجانية ومفتوحة المصدر، دون الاعتماد على Microsoft Outlook.
مكتبة C++ مفتوحة المصدر لملفات MSG و CFB
Aspose.Email FOSS for C++ هي مكتبة C++ مفتوحة المصدر مرخصة بموجب رخصة MIT للعمل مع ملفات Microsoft Outlook .msg وحاويات Compound File Binary (CFB). قم بتضمين رؤوس الملفات عبر CMake وابدأ فورًا في قراءة وإنشاء ومعالجة رسائل البريد الإلكتروني دون تثبيت Microsoft Outlook أو أي بيئة تشغيل مملوكة.
توفر المكتبة مستويين من الوصول. على المستوى المنخفض، يمنحك cfb_reader و cfb_writer تحكمًا كاملاً في حاويات CFB الثنائية — استعراض إدخالات الدليل، قراءة وكتابة عقد التخزين وبيانات التدفق، وفحص تخطيط القطاعات الخام. يتعامل msg_reader و msg_writer مع تنسيق MSG فوق CFB، مكشفين عن تدفقات خصائص MAPI، جداول المستلمين، وتخزينات المرفقات الفرعية. على المستوى العالي، يتيح لك mapi_message إنشاء رسائل جديدة من الصفر، قراءة العناوين، النصوص، المستلمين، والمرفقات، وتحويل بين تنسيق MSG و EML.
تُبنى المكتبة على أي منصة تحتوي على مترجم C++17 ولا تعتمد على أي تبعيات خارجية، مما يجعلها مناسبة لـ Windows و Linux و macOS وحاويات Docker والأنظمة المدمجة.
CFB Container Read and Write
- Open CFB files: Load existing CFB containers from a file path, stream, or byte array via
cfb_reader::from_file(),cfb_reader::from_stream(), orcfb_reader::from_bytes(). - Traverse the directory tree: Enumerate storages and streams using
storage_ids(),stream_ids(), andchild_ids(), and navigate nested hierarchies withresolve_path(). - Inspect nodes: Check node type with
cfb_node::is_storage()andcfb_node::is_stream(), read timestamps viacreation_time()andmodified_time(). - Write CFB containers: Build CFB documents programmatically with
cfb_documentand serialize to bytes or file viacfb_writer::to_bytes()orcfb_writer::write_file().
Where CFB Access Is Used
- MSG file inspection: CFB is the container format for Outlook
.msgfiles — direct CFB access enables forensic inspection and repair. - Custom binary formats: Any legacy application using CFB for data storage can be read or written without a COM dependency.
- Data recovery: Traverse the full directory tree and extract raw stream bytes from damaged or non-standard CFB files.
MSG File Read and Write
- Read MSG files: Open Outlook MSG files with
msg_reader::from_file()ormsg_reader::from_stream()and access the underlying MAPI property streams and attachment sub-storages. - Write MSG files: Produce MSG files from a
msg_documentwithmsg_writer::to_bytes()ormsg_writer::write_file(). - MSG document inspection: Access version metadata via
msg_document::major_version(),msg_document::minor_version(), and check strictness withmsg_document::strict(). - Convert to CFB: Extract the underlying CFB document from an MSG file via
msg_document::to_cfb_document().
Where MSG Processing Is Used
- Email archival pipelines: Bulk-read
.msgfiles from archive directories and extract metadata or attachments. - Migration tools: Convert MSG collections to standard formats for import into non-Outlook systems.
- Legal discovery: Parse raw MAPI property streams to extract all message fields including non-standard properties.
High-Level MAPI Message API
- Create messages: Build a complete email with
mapi_message::create(), then set subject, body, and HTML body viaset_subject(),set_body(), andset_html_body(). - Set sender details: Configure
set_sender_name(),set_sender_email_address(), andset_sender_address_type()for the outgoing message. - Manage attachments: Load attachments from bytes or streams with
mapi_attachment::from_bytes()andmapi_attachment::from_stream(), and check for embedded messages viais_embedded_message(). - Save and reload: Serialize with
mapi_message::save()and reload withmapi_message::from_file()ormapi_message::from_stream().
Where the High-Level API Is Used
- Automated email generation: Generate thousands of personalized MSG files from data records in batch jobs.
- Test fixture creation: Build known-good MSG files with predictable content for integration test suites.
- Attachment extraction: Load an MSG file, iterate attachments, and save each to disk.
EML and MIME Conversion
- Load EML into mapi_message: Parse a standard
.emlfile (RFC 5322 / MIME) into a fullmapi_messageobject viamapi_message::load_from_eml(). - Save mapi_message as EML: Serialize a
mapi_messageback to MIME format withsave_to_eml(). - Round-trip fidelity: Subject, body, sender, recipients, and attachments are preserved through EML to MSG to EML round-trips.
Where EML Conversion Is Used
- Format bridging: Receive emails as EML from mail servers and convert to MSG for Outlook-compatible storage.
- Standards compliance: Convert proprietary MSG files to standard MIME for delivery to any mail transport.
- Archival normalization: Normalize a mixed archive of
.emland.msgfiles to a single format.
Read Subject from an MSG File
Open an Outlook MSG file from a stream and print the subject — no Microsoft Outlook required.
#include <fstream>
#include <iostream>
#include "aspose/email/foss/msg/mapi_message.hpp"
int main()
{
std::ifstream input("sample.msg", std::ios::binary);
auto message = aspose::email::foss::msg::mapi_message::from_stream(input);
std::cout << message.subject() << '\n';
}
Create and Save an MSG Message
Build a complete email with sender, recipient, and attachment, then write it to both MSG and EML formats.
#include <fstream>
#include "aspose/email/foss/msg/mapi_message.hpp"
int main()
{
auto message = aspose::email::foss::msg::mapi_message::create("Hello", "Body");
message.set_sender_name("Alice");
message.set_sender_email_address("alice@example.com");
message.add_recipient("bob@example.com", "Bob");
message.add_attachment("note.txt", std::vector<std::uint8_t>{'a', 'b', 'c'}, "text/plain");
std::ofstream msg_output("hello.msg", std::ios::binary);
message.save(msg_output);
std::ofstream eml_output("hello.eml", std::ios::binary);
message.save_to_eml(eml_output);
}
