Bevezetés

A C++-ben az Outlook MSG fájlokkal való munka történelmileg csak Windows COM automatizálását vagy szigorú licenceket tartalmazó nehézkes harmadik fél könyvtárakat igényelt. Aspose.Email FOSS for C ++ változások: ez egy tiszta C + + 17 könyvház, külső függőségek nélkül, nem COM és nincs platformspecifikus kód. Egyformán épül Linuxon, macOSon és Windowson.

A könyvtár a MIT licenc alatt kerül kiadásra, és forrásként GitHub-on keresztül terjesztésre. Az integrációhoz klónozni kell az adattárat, majd hozzáadni azt CMake alszókönyvként nincs szükség csomagkezelő regisztrálásra, nem is szükséges előzetes bináris felépítés.

Ez a bejegyzés az alapvető munkafolyamaton keresztül halad: egy meglévő MSG fájlt olvasni, tulajdonságait ellenőrizni, új üzenetet létrehozni programmatically és körbe-körbe utazás az MS G és EML formátumok között.

Fő jellemzői

Meglévő MSG fájlok olvasása

Használat msg_reader a nyitás .msg aktát és msg_document hozzáférni a szerkezetbe foglalott tartalomhoz. Mindkét osztály a következőkben él: aspose::email::foss::msg névterület.

#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 A from_stream A túlterhelés a std::istream, ami hasznos a szerver- vagy csővezetékoldalon, ahol nem találhatóak fájlok lemezben.

Üzenetek programozásával történő létrehozása

mapi_message::create Új üzenetet hoz létre a memóriában, egy tárgy és test. utána beállíthatja a küldő részleteit, hozzáadhatja az átvevőket és csatolhat bináris vagy szöveges hasznos terheléseket mielőtt - Megmenteni.

#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-t EML-re alakítani

mapi_message a közvetlen MSG-EML átváltást támogatja az save_to_eml módszer. Az EML kimeneti megfelel az RFC 5322 (MIME), így kompatibilis bármely szabványos mail. ügyfél vagy feldolgozó csővezeték.

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

EML-ből származó terhelés

A fordított irány ugyanolyan egyszerű: load_from_eml EML fájlt olvassa. és egy mapi_message a memóriában, amit aztán vissza lehet menteni az 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

A MAPI-készülékben nem feltárt tulajdonságok olvasása, például a fejlett alkalmazási esetekre magas szintű API cfb_reader közvetlen hozzáférést biztosít a Kompound File Binary konténernek. amely alátámasztja az MSG formátumot.

#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 Klon és mellékjegyzékké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 Beilleszteni és használni

#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 Építsen

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

Támogatott formátumok

FormátumA BizottságOlvasd!Írj!
MSG (Outlook üzenet).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary).msg, .cfb✓✓

Nyitott forráskódú és licenckészítés

Aspose.Email FOSS for C++ is released under the MIT license. The full source is available GitHub-on a következő címre: Az e-mailben szereplő adatok és a felhasználó által használt információk.. A könyvtár nem futási idő függőségek. C++17-es és CMake 3.26 vagy újabb kompilátoron túl.

Kezdjük!