Введение

Работа с файлами Outlook MSG на C++ исторически требовала только Windows‑only COM‑автоматизацию
или тяжёлые сторонние библиотеки с ограничительными лицензиями. Aspose.Email FOSS для C++
изменяет это: это чистая библиотека C++17 без внешних зависимостей, без COM и без
кода, зависящего от платформы. Она собирается одинаково на Linux, macOS и Windows.

Библиотека распространяется под лицензией MIT и доступна в виде исходного кода через GitHub. Вы интегрируете её, клонировав репозиторий и добавив его как подкаталог CMake — регистрация в менеджере пакетов не требуется, и предварительно собирать бинарные файлы не нужно.

В этом посте рассматривается основной рабочий процесс: чтение существующего файла MSG, проверка его свойств, программное создание нового сообщения и обратное преобразование между форматами MSG и EML.

Ключевые особенности

Чтение существующих MSG‑файлов

Используйте msg_reader, чтобы открыть файл .msg, и msg_document, чтобы получить доступ к его структурированному содержимому.
Оба класса находятся в пространстве имён 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 также имеет from_stream перегрузку для чтения из std::istream, что полезно в серверных или конвейерных контекстах, где файлы отсутствуют на диске.

Создать сообщения программно

mapi_message::create создает новое сообщение в памяти с темой и телом. Затем вы можете задать данные отправителя, добавить получателей и прикрепить двоичные или текстовые полезные нагрузки перед сохранением.

#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 в EML

mapi_message поддерживает прямое преобразование MSG в EML с помощью метода save_to_eml.
Вывод EML соответствует RFC 5322 (MIME), что делает его совместимым с любым стандартным почтовым клиентом
или конвейером обработки.

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

Обратное направление также простое: load_from_eml читает файл EML и создает mapi_message в памяти, который затем можно сохранить обратно в MSG.

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

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

Низкоуровневый доступ к CFB

Для продвинутых сценариев использования — таких как чтение необработанных свойств MAPI, не доступных через высокоуровневый API — cfb_reader предоставляет прямой доступ к контейнеру Compound File Binary, лежащему в основе формата 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();

Быстрый старт

Шаг 1 — Клонировать и добавить как подкаталог

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

В вашем проекте 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 — Подключить и использовать

#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 — Сборка

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

Поддерживаемые форматы

ФорматРасширениеЧтениеЗапись
MSG (Outlook Message).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary).msg, .cfb✓✓

Открытый исходный код и лицензирование

Aspose.Email FOSS for C++ выпущен под лицензией MIT. Полный исходный код доступен
на GitHub по адресу aspose-email-foss/Aspose.Email-FOSS-for-Cpp.
Коммерческое использование разрешено без роялти. Библиотека не имеет runtime‑зависимостей
помимо компилятора C++17 и CMake 3.26 или более новой версии.

Начало работы