Introducere

Lucrarea cu fișierele Outlook MSG în C++ a necesitat, istoric, automatizare COM numai pentru Windows sau biblioteci de terțe părți grele cu licențe restrictive. Aspose.Email FOSS pentru C ++ schimbări care: este o librărie pură C + 17 fără dependențe externe, fără COM și fără cod specific platformei. Se construiește identic pe Linux, macOS și Windows.

Biblioteca este eliberată sub licența MIT și distribuită ca sursă prin GitHub. O integrați clonând depozitul și adăugându-l ca un subdirectoriu CMake nu este necesară înregistrarea managerului de pachete, iar nici binare nu trebuie să fie pre-construite.

Acest articol trece prin fluxul de lucru principal: citirea unui fișier MSG existent, inspecția proprietăților sale, crearea unui nou mesaj programatic și redirecționarea între formatele MS G și EML.

Caracteristici cheie

Citeste fişierele existente MSG

Utilizare: msg_reader să deschidă o .msg dosar şi msg_document pentru a accesa conținutul său structurat. Ambele clase trăiesc în aspose::email::foss::msg spațiul de nume.

#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 are şi o from_stream supraîncărcare pentru citirea de la un std::istream, care este utilă în contexturile de pe server sau pipeline unde fișierele nu sunt prezente pe disc.

Creează mesaje programate

mapi_message::create produce un nou mesaj în memorie cu subiect şi corp. apoi poate seta detaliile de trimitere, adăuga destinatari și atașează binar sau text payloads înainte de a fi utilizate pentru o serie de servicii. Salvare.

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

Convertiti MSG în EML

mapi_message sprijină conversiunea directă de MSG în EML prin intermediul sistemului de transformare a glicemiei. save_to_eml metodă. ieșirea EML este conformă cu RFC 5322 (MIME), făcându-l compatibil cu orice mail standard, client sau conducte de prelucrare.

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

Sarcină din EML

Direcţia inversă e la fel de directă: load_from_eml citește un fișier EML și produce o mapi_message în memorie, care poate fi apoi salvată înapoi la MSG.

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

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

Acces CFB la nivel scăzut

Pentru cazuri de utilizare avansate cum ar fi citirea proprietăţilor MAPI crude care nu sunt expuse prin intermediul sistemului de analiză a informaţiilor. API de nivel înalt cfb_reader oferă acces direct la containerul Compound File Binary care susține formatul MSG.

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

Început rapid

Pasul 1 Clonați și adăugați ca subdirectoriu

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

În proiectul tău. 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)

Pasul 2 Includeți și utilizați

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

Pasul 3 Construiți

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

Formatele suportate

FormatulExtindereCiteşte.Scrie .
MSG (Mesaj de perspectivă).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (compozit binar de fișiere).msg, .cfb✓✓

Open Source & Licențiere

Aspose.Email FOSS for C++ is released under the MIT license. The full source is available pe GitHub la: Aspose-email-foss/Aspose.Email-FOSS-for-Cpp. Utilizarea comercială este permisă fără redevențe. Biblioteca nu are dependențe de runtime mai mult decât un compilator C++17 și CMake 3.26 sau ulterior.

Cum să începem?