Introduktion

Att arbeta med Outlook MSG-filer i C++ har historiskt krävt Windows‑endast COM‑automation
eller tunga tredjepartsbibliotek med restriktiva licenser. Aspose.Email FOSS för C++
ändrar detta: det är ett rent C++17‑bibliotek utan externa beroenden, utan COM och utan
plattformsspecifik kod. Det byggs identiskt på Linux, macOS och Windows.

Biblioteket är släppt under MIT-licensen och distribueras som källkod via GitHub. Du integrerar det genom att klona repot och lägga till det som en CMake-undermapp — ingen paketmanagerregistrering krävs, och inga binärer behöver förbyggas.

Detta inlägg går igenom det grundläggande arbetsflödet: läsa en befintlig MSG‑fil, inspektera dess egenskaper, skapa ett nytt meddelande programatiskt och round‑tripping mellan MSG‑ och EML‑format.

Nyckelfunktioner

Läs befintliga MSG‑filer

Använd msg_reader för att öppna en .msg‑fil och msg_document för att komma åt dess strukturerade innehåll.
Båda klasserna finns i namnutrymmet aspose::email::foss::msg.

#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 också en from_stream-överladdning för att läsa från en std::istream, vilket är användbart i server‑sidiga eller pipeline‑sammanhang där filer inte finns på disken.

Skapa meddelanden programatiskt

mapi_message::create skapar ett nytt meddelande i minnet med ett ämne och en brödtext.
Du kan sedan ange avsändarinformation, lägga till mottagare och bifoga binära eller textbaserade data innan du sparar.

#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"));

Konvertera MSG till EML

mapi_message stöder direkt MSG‑till‑EML‑konvertering via save_to_eml‑metoden.
EML‑utdata följer RFC 5322 (MIME), vilket gör den kompatibel med någon standardmail
klient eller bearbetningspipeline.

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();

Ladda från EML

Den omvända riktningen är lika enkel: load_from_eml läser en EML‑fil och producerar en mapi_message i minnet, som sedan kan sparas tillbaka till MSG.

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

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

Lågnivå CFB-åtkomst

För avancerade användningsfall — såsom att läsa råa MAPI‑egenskaper som inte exponeras av det hög‑nivå‑API‑et — cfb_reader ger direkt åtkomst till den Compound File Binary‑behållaren som ligger till grund för 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();

Snabbstart

Steg 1 — Klona och lägg till som underkatalog

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

I ditt 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)

Steg 2 — Inkludera och använd

#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";
}

Steg 3 — Bygg

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

Stödda format

FormatFiländelseLäsaSkriva
MSG (Outlook‑meddelande).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary).msg, .cfb✓✓

Öppen källkod & licensiering

Aspose.Email FOSS för C++ är släppt under MIT-licensen. Den fullständiga källkoden är tillgänglig
på GitHub på aspose-email-foss/Aspose.Email-FOSS-for-Cpp.
Kommersiell användning är tillåten utan royalties. Biblioteket har inga körtidssberoenden
utöver en C++17-kompilator och CMake 3.26 eller senare.

Komma igång