Introduktion
Att arbeta med Outlook MSG-filer i C++ har historiskt sett krävt Windows-endast COM-automatisering eller tunga tredjepartsbibliotek med restriktiva licenser. Aspose.Email FOSS för C++ ändrar det: det är ett rent C++17-bibliotek utan externa beroenden, ingen COM och ingen plattforms-specifik kod. Det byggs identiskt på Linux, macOS och Windows.
Biblioteket släpps 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 registrering i pakethanterare krävs, och inga binärer behöver förbyggas.
Detta inlägg går igenom huvudarbetsflödet: läsa en befintlig MSG-fil, inspektera dess egenskaper, skapa ett nytt meddelande programmässigt och göra en round-trip mellan MSG- och EML-format.
Viktiga funktioner
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 aspose::email::foss::msg-namnutrymmet.
#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 overload 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å disk.
Skapa meddelanden programatiskt
mapi_message::create skapar ett nytt meddelande i minnet med ett ämne och en kropp. Du kan sedan ange avsändardetaljer, lägga till mottagare och bifoga binära eller textbaserade payloads 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ödjer direkt MSG-till-EML-konvertering via save_to_eml-metoden. EML-utdata följer RFC 5322 (MIME), vilket gör den kompatibel med alla standard e-postklienter eller behandlings-pipeline.
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();
Läs in 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 den högnivå API — cfb_reader ger direkt åtkomst till den Compound File Binary-behållare 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
| Format | Filändelse | Läsa | Skriva |
|---|---|---|---|
| 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 finns 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örtidsberoenden utöver en C++17-kompilator och CMake 3.26 eller senare.
