Въведение

Работата с Outlook MSG файлове в C++ исторически изисква само автоматизация на Windows COM или тежки библиотеки от трети страни с ограничителни лицензи. Aspose.Email FOSS за C ++ променя това: тя е чиста библиотека C + 17 без външни зависимост, няма COM и не платформи-специфичен код. Тя изгражда идентично на Linux, macOS и Windows.

Библиотеката се издава под лиценза на MIT и се разпространява като източник чрез GitHub. Вие я интегрирате, като клонирате репозиторията и го добавяте като поддиректор CMake - няма нужда от регистрация за мениджър на пакети и не е необходимо да бъдат предварително изградени бинарни.

Този пост преминава през основния работен поток: четене на съществуващ MSG файл, проверка на неговите свойства, създаване на нова съобщение програмирано и кръг-трипинг между формати MSM и EML.

Ключови характеристики

Прочетете съществуващите MSG файлове

Използване msg_reader За да отворите A .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-to-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 файл и произвежда A 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 дават директен достъп до комбиниран файлов бинарния контейнер Това е форма на 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++ is released under the MIT license. The full source is available на GitHub в e-mail / за да се изпратите на имейл / Aspose.e-Mail - FOSS - for-Cpp. Търговска употреба е позволена без роялти. библиотеката няма зависимост от работното време - над C++17 и CMake 3.26 или по-късно.

Започваме