Introduction

C++‘da Outlook MSG dosyaları ile çalışmak, tarihsel olarak yalnızca COM otomatikleştirme veya sınırlayıcı lisansları olan ağır üçüncü taraf kütüphaneleri gerektirmiştir. Aspose.C++ için E-posta FOSS değişiklikler: dış bağımlılıklar, hiçbir COM ve platform özel kodları olmayan saf bir C ++17 kütüphane. Linux, macOS ve Windows’ta aynı şekilde inşa eder.

Kütüphane MIT lisansı altında yayınlanır ve GitHub aracılığıyla kaynağı olarak dağıtılır. depolama alanını klonlayarak entegre edersiniz ve CMake alt adresi olarak eklenir - paket yöneticisi kayıt gerektirmez ve hiçbir binar önceden inşa edilmemelidir.

Bu yazı temel çalışma akışını geçiyor: mevcut bir MSG dosyasını okuyun, özelliklerini inceleyin, yeni bir mesaj programlı olarak oluşturun ve MSM ve EML biçimleri arasında yuvarlak çizgiler.

Ana Özellikler

Mevcut MSG dosyalarını okuyun

Kullanım msg_reader A’yı açmak için .msg Dosya ve msg_document Yapılandırılmış içeriğine erişmek. Her iki sınıf da içinde yaşar. aspose::email::foss::msg Adı Soyadı.

#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 Ayrıca bir from_stream Yüzeyde bir okuma için bir std::istream, Bu, dosyaların diske bulunmadığı sunucu tarafında veya boru hattı bağlamlarında yararlıdır.

Mesajları programlı olarak oluşturun

mapi_message::create bir konu ve vücuda yeni bir hafıza mesajı üretir. Daha sonra göndericinin detaylarını ayarlayabilir, alıcıları ekleyebilir ve ikili veya metin ödeme yüklerini eklemek için önce kurtarma için.

#include "aspose/email/foss/msg/mapi_message.hpp"

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’yi EML’ye dönüştürmek

mapi_message MSG-EML dönüşümünü doğrudan destekler. save_to_eml Yöntemleri . EML çıkışı RFC 5322 (MIME) ile uyumludur, bu da standart posta ile aynıdır. Müşteri veya işleme boru hattı.

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’den Yükleme

Yönü aynı derecede düzgün: load_from_eml EML dosyası okuyun üretir ve a mapi_message Bu durum, MSG’ye geri dönüş yapabiliyor.

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

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

Düşük Seviyeli CFB Erişimi

Gelişmiş kullanım durumları için - örneğin, okuma MAPI özellikleri tarafından maruz kalmamış Yüksek düzeyde ateş - cfb_reader Bina Dosya Konteynerine Doğrudan Erişim Veriyor Bu da MSG formatını oluşturur.

#include "aspose/email/foss/cfb/cfb_reader.hpp"

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

Hızlı Başlangıç

Adım 1 - Klon ve Alt Yönetici olarak Ekle

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

Projeye göre 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)

Adım 2 - İçeri ve Kullanımı

#include <iostream>
#include "aspose/email/foss/msg/mapi_message.hpp"

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

Adım 3 - Yapılandırma

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

Desteklenen Formatlar

FormatExtensionReadWrite
MSG (Outlook Mesajı).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary) ile ilgili bilgiler.msg, .cfb✓✓

Açık Kaynak & Lisans

Aspose.Email FOSS for C++ is released under the MIT license. The full source is available GitHub’da e-posta adresi - mail adresini - info@foss.com. Ticari kullanım royalties olmadan izin verilir. kütüphane çalışma saatine bağlı değildir C++17 ve CMake 3.26 veya daha sonraki bir kompozitörün ötesinde.

Başlamaya başlar