Aspose.Email FOSS for C++
Les, opprett og behandle Outlook MSG-filer og CFB-beholdere fra C++ — gratis og åpen kildekode, ingen Microsoft Outlook-avhengighet.
Open-Source C++-bibliotek for MSG- og CFB-filer
Aspose.Email FOSS for C++ er et MIT‑lisensiert, åpen kildekode C++‑bibliotek for å arbeide med Microsoft Outlook .msg‑filer og Compound File Binary (CFB)‑containere. Inkluder headerne via CMake og begynn umiddelbart å lese, opprette og behandle e‑postmeldinger uten å installere Microsoft Outlook eller noen proprietær kjøretidsmiljø.
Biblioteket gir to nivåer av tilgang. På lavt nivå gir cfb_reader og cfb_writer full kontroll over CFB‑binære containere — traversere katalogoppføringer, lese og skrive lagringsnoder og strømdata, og inspisere den rå sektoroppsettet. msg_reader og msg_writer håndterer MSG‑formatet på toppen av CFB, og eksponerer MAPI‑egenskapsstrømmer, mottakertabeller og vedleggsunderlagre. På høyt nivå lar mapi_message deg opprette nye meldinger fra bunnen av, lese emner, innhold, mottakere og vedlegg, og konvertere mellom MSG‑ og EML‑format.
Biblioteket kan bygges på enhver plattform med en C++17‑kompilator og har ingen eksterne avhengigheter, noe som gjør det egnet for Windows, Linux, macOS, Docker‑containere og innebygde systemer.
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);
}
