Introduktion

At arbejde med Outlook MSG-filer i C++ har historisk set krævet Windows‑kun COM‑automatisering
eller tunge tredjepartsbiblioteker med restriktive licenser. Aspose.Email FOSS for C++
ændrer dette: det er et rent C++17‑bibliotek uden eksterne afhængigheder, ingen COM, og ingen
platformsspecifik kode. Det bygger identisk på Linux, macOS og Windows.

Biblioteket er udgivet under MIT-licensen og distribueres som kildekode via GitHub. Du integrerer det ved at klone repository’et og tilføje det som en CMake-underbibliotek — ingen registrering i pakkehåndtering er påkrævet, og ingen binære filer behøver at blive forudbygget.

Dette indlæg gennemgår den grundlæggende arbejdsgang: læse en eksisterende MSG‑fil, inspicere dens egenskaber, oprette en ny besked programmatisk og foretage round‑tripping mellem MSG‑ og EML‑formater.

Nøglefunktioner

Læs eksisterende MSG-filer

Brug msg_reader til at åbne en .msg fil og msg_document for at få adgang til dens strukturerede indhold.
Begge klasser findes i aspose::email::foss::msg-navneområdet.

#include "aspose/email/foss/msg/msg_reader.hpp"
#include "aspose/email/foss/msg/msg_document.hpp"
#include <filesystem>

namespace aef = aspose::email::foss;

auto reader   = aef::msg::msg_reader::from_file(std::filesystem::path("message.msg"));
auto document = aef::msg::msg_document::from_reader(reader);

msg_reader har også en from_stream overload til at læse fra en std::istream, hvilket er nyttigt i server‑side eller pipeline‑kontekster, hvor filer ikke er til stede på disken.

Opret meddelelser programmatisk

mapi_message::create opretter en ny in‑memory‑meddelelse med et emne og en brødtekst. Du kan derefter angive afsenderoplysninger, tilføje modtagere og vedhæfte binære eller tekst‑payloads, før du gemmer.

#include "aspose/email/foss/msg/mapi_message.hpp"

namespace aef = aspose::email::foss;

auto msg = aef::msg::mapi_message::create(
    "Quarterly status update",
    "Hello team,\n\nPlease find the rollout summary attached.\n\nRegards");

msg.set_sender_name("Build Agent");
msg.set_sender_email_address("build.agent@example.com");
msg.add_recipient("alice@example.com", "Alice Example");
msg.save(std::filesystem::path("output.msg"));

Konverter MSG til EML

mapi_message understøtter direkte MSG-til-EML konvertering via save_to_eml metoden.
EML-output overholder RFC 5322 (MIME), hvilket gør den kompatibel med enhver standard mail
klient eller behandlingspipeline.

auto loaded = aef::msg::mapi_message::from_file(
    std::filesystem::path("message.msg"), /*strict=*/false);

// Save as EML to a file
loaded.save_to_eml(std::filesystem::path("message.eml"));

// Or capture as bytes
std::vector<std::uint8_t> eml_bytes = loaded.save_to_eml();

Indlæs fra EML

Den omvendte retning er lige så ligetil: load_from_eml læser en EML‑fil og producerer en mapi_message i hukommelsen, som derefter kan gemmes tilbage til MSG.

auto from_eml = aef::msg::mapi_message::load_from_eml(
    std::filesystem::path("message.eml"));

from_eml.save(std::filesystem::path("restored.msg"));

Lavt niveau CFB-adgang

Til avancerede brugsscenarier — såsom at læse rå MAPI‑egenskaber, der ikke er eksponeret af den højniveau‑API — cfb_reader giver direkte adgang til den Compound File Binary‑beholder, som ligger til grund for MSG‑formatet.

#include "aspose/email/foss/cfb/cfb_reader.hpp"

namespace aef = aspose::email::foss;

auto cfb = aef::cfb::cfb_reader::from_file(std::filesystem::path("message.msg"));
auto storage_ids = cfb.storage_ids();
auto stream_ids  = cfb.stream_ids();

Hurtig start

Trin 1 — Klon og tilføj som undermappe

git clone https://github.com/aspose-email-foss/Aspose.Email-FOSS-for-Cpp.git

I dit projekt CMakeLists.txt:

cmake_minimum_required(VERSION 3.26)
project(my_project)

add_subdirectory(Aspose.Email-FOSS-for-Cpp)

add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE AsposeEmailFoss::AsposeEmailFoss)

Trin 2 — Inkluder og brug

#include <iostream>
#include "aspose/email/foss/msg/mapi_message.hpp"

namespace aef = aspose::email::foss;

int main()
{
    // Create a message
    auto msg = aef::msg::mapi_message::create("Hello from C++", "Body text here");
    msg.save(std::filesystem::path("hello.msg"));

    // Round-trip to EML
    auto loaded = aef::msg::mapi_message::from_file(
        std::filesystem::path("hello.msg"), false);
    loaded.save_to_eml(std::filesystem::path("hello.eml"));

    std::cout << "Done\n";
}

Trin 3 — Byg

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

Understøttede formater

FormatUdvidelseLæsSkriv
MSG (Outlook Message).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary).msg, .cfb✓✓

Open Source & Licensering

Aspose.Email FOSS for C++ er udgivet under MIT-licensen. Den fulde kildekode er tilgængelig
på GitHub på aspose-email-foss/Aspose.Email-FOSS-for-Cpp.
Kommerciel brug er tilladt uden royalties. Biblioteket har ingen runtime-afhængigheder
ud over en C++17-kompilator og CMake 3.26 eller senere.

Kom i gang