Bevezetés

Az Outlook MSG fájlok C++‑ban történő kezelése történelmileg Windows‑specifikus COM automatizálást igényelt
vagy nehéz, korlátozott licencű harmadik fél könyvtárakat. Aspose.Email FOSS for C++
megváltoztatja ezt: ez egy tiszta C++17 könyvtár, külső függőségek, COM és
platformspecifikus kód nélkül. Azonos módon épül Linuxon, macOS‑en és Windowson.

A könyvtár MIT licenc alatt kerül kiadásra, és forráskódként terjesztik a GitHubon keresztül.
Ön integrálja a tárolót a klónozással, és CMake alkönyvtárként adja hozzá —
nem szükséges csomagkezelő regisztráció, és nem kell előre lefordított binárisokat készíteni.

Ez a bejegyzés végigvezet a fő munkafolyamaton: egy meglévő MSG fájl beolvasása, annak tulajdonságainak ellenőrzése, egy új üzenet programozott létrehozása, valamint az MSG és az EML formátumok közötti körkörös átalakítás.

Főbb funkciók

Meglévő MSG fájlok olvasása

Használja a msg_reader parancsot egy .msg fájl megnyitásához, és a msg_document‑t a strukturált tartalom eléréséhez.
Mindkét osztály a aspose::email::foss::msg névtérben található.

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

A msg_reader rendelkezik egy from_stream túlterheléssel, amely lehetővé teszi a beolvasást egy std::istream‑ból, ami hasznos szerveroldali vagy csővezeték‑környezetekben, ahol a fájlok nem állnak rendelkezésre a lemezen.

Üzenetek programozott létrehozása

mapi_message::create új memóriában tárolt üzenetet hoz létre tárggyal és törzzsel. Ezután beállíthatja a feladó adatait, hozzáadhat címzetteket, és csatolhat bináris vagy szöveges payloads‑t a mentés előtt.

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

MSG konvertálása EML-be

mapi_message közvetlen MSG‑to‑EML átalakítást támogat a save_to_eml módszerrel.
Az EML kimenet megfelel az RFC 5322 (MIME) szabványnak, így kompatibilis bármely szabványos
levélkliensekkel vagy feldolgozási csővezetékkel.

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

Betöltés EML‑ből

A fordított irány is egyformán egyszerű: load_from_eml beolvas egy EML fájlt, és egy mapi_message-t hoz létre a memóriában, amelyet ezután vissza lehet menteni MSG-be.

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

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

Alacsony szintű CFB hozzáférés

Haladó felhasználási esetekhez — például a magas szintű API által nem elérhető nyers MAPI tulajdonságok olvasásához — cfb_reader közvetlen hozzáférést biztosít a Compound File Binary tárolóhoz, amely az MSG formátum alapját képezi.

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

Gyors kezdés

1. lépés — Klónozás és almappaként hozzáadás

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

A projektedben 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)

2. lépés — Beillesztés és használat

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

3. lépés — Felépítés

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

Támogatott formátumok

FormátumKiterjesztésOlvasásÍrás
MSG (Outlook Message).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary).msg, .cfb✓✓

Nyílt forráskód és licencelés

Aspose.Email FOSS for C++ az MIT licenc alatt kerül kiadásra. A teljes forrás elérhető a GitHubon a aspose-email-foss/Aspose.Email-FOSS-for-Cpp címen. A kereskedelmi felhasználás jogdíjmentes. A könyvtárnak nincsenek futásidejű függőségei kivéve egy C++17 fordítót és a CMake 3.26 vagy újabb verzióját.

Első lépések