Introducción

Trabajar con archivos Outlook MSG en C++ históricamente ha requerido automatización COM exclusiva de Windows o bibliotecas de terceros pesadas con licencias restrictivas. Aspose.Email FOSS para C++ cambia eso: es una biblioteca pura de C++17 sin dependencias externas, sin COM y sin código específico de plataforma. Se compila de manera idéntica en Linux, macOS y Windows.

La biblioteca se publica bajo la licencia MIT y se distribuye como código fuente a través de GitHub. La integras clonando el repositorio y añadiéndolo como subdirectorio de CMake — no se requiere registro en un gestor de paquetes, y no es necesario compilar previamente los binarios.

Esta publicación recorre el flujo de trabajo principal: leer un archivo MSG existente, inspeccionar sus propiedades, crear un nuevo mensaje programáticamente y realizar una conversión de ida y vuelta entre los formatos MSG y EML.

Características clave

Leer archivos MSG existentes

Use msg_reader para abrir un archivo .msg y msg_document para acceder a su contenido estructurado. Ambas clases se encuentran en el espacio de nombres 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 también tiene una from_stream sobrecarga para leer desde un std::istream, lo que es útil en contextos del lado del servidor o de canalización donde los archivos no están presentes en el disco.

Crear mensajes programáticamente

mapi_message::create produce un nuevo mensaje en memoria con un asunto y cuerpo. Puedes entonces establecer los detalles del remitente, agregar destinatarios y adjuntar cargas útiles binarias o de texto antes de guardar.

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

Convertir MSG a EML

mapi_message admite la conversión directa de MSG a EML mediante el método save_to_eml.
La salida EML se ajusta a RFC 5322 (MIME), lo que la hace compatible con cualquier cliente de correo estándar
o canal de procesamiento.

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

Cargar desde EML

La dirección inversa es igualmente sencilla: load_from_eml lee un archivo EML y produce un mapi_message en memoria, que luego puede guardarse de nuevo en MSG.

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

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

Acceso CFB de bajo nivel

Para casos de uso avanzados — como leer propiedades MAPI sin procesar que no expone la API de alto nivel — cfb_reader brinda acceso directo al contenedor Compound File Binary que sustenta el formato 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();

Inicio rápido

Paso 1 — Clonar y agregar como subdirectorio

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

En su proyecto 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)

Paso 2 — Incluir y usar

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

Paso 3 — Compilar

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

Formatos compatibles

FormatoExtensiónLecturaEscritura
MSG (Outlook Message).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary).msg, .cfb✓✓

Código abierto y licencias

Aspose.Email FOSS for C++ se publica bajo la licencia MIT. El código fuente completo está disponible en GitHub en aspose-email-foss/Aspose.Email-FOSS-for-Cpp. El uso comercial está permitido sin regalías. La biblioteca no tiene dependencias en tiempo de ejecución más allá de un compilador C++17 y CMake 3.26 o posterior.

Primeros pasos