Aspose.Email FOSS per C++
Leggi, crea e elabora file Outlook MSG e contenitori CFB da C++ — gratuito e open‑source, senza dipendenza da Microsoft Outlook.
Libreria C++ Open-Source per file MSG e CFB
Aspose.Email FOSS for C++ è una libreria C++ open‑source con licenza MIT per lavorare con i file .msg di Microsoft Outlook e i contenitori Compound File Binary (CFB). Includi gli header tramite CMake e inizia subito a leggere, creare e processare messaggi email senza installare Microsoft Outlook o alcun runtime proprietario.
La libreria fornisce due livelli di accesso. A basso livello, cfb_reader e cfb_writer offrono il controllo completo sui contenitori binari CFB — attraversare le voci di directory, leggere e scrivere nodi di storage e dati di stream, e ispezionare il layout grezzo dei settori. msg_reader e msg_writer gestiscono il formato MSG sopra CFB, esponendo i flussi di proprietà MAPI, le tabelle dei destinatari e i sotto‑storage degli allegati. A livello alto, mapi_message ti consente di creare nuovi messaggi da zero, leggere oggetti, corpi, destinatari e allegati, e convertire tra formato MSG ed EML.
La libreria si compila su qualsiasi piattaforma con un compilatore C++17 e non ha dipendenze esterne, rendendola adatta per Windows, Linux, macOS, contenitori Docker e sistemi embedded.
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);
}
