Özellikler

Özellik Genel Bakışı

Aspose.Email FOSS for C++ Outlook MSG dosyaları ve Compound File Binary (CFB) konteynerleriyle çalışmak için katmanlı bir API sağlar. Kütüphane, iki alt sistem: CFB ve MSG/MAPI içinde 26 genel sınıfa sahiptir.


CFB Konteyner Erişimi

CFB alt sistemi, Outlook .msg dosyalarının temelini oluşturan kapsayıcı format olan Microsoft Compound File Binary formatını okur ve yazar.

SınıfAmaç
cfb_readerMevcut CFB dosyalarını aç ve dolaş
cfb_writerCFB belgelerini baytlara veya dosyalara serileştir
cfb_documentBir CFB dosyasının bellek içi temsili
cfb_nodeDizin ağacındaki bireysel depolama veya akış düğümü
cfb_storageAdlandırılmış depolama girişi
cfb_streamİkili veri içeren adlandırılmış akış

Temel işlemler:

  • Dosyadan, akıştan veya baytlardan aç: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
  • İçerikleri numaralandır: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
  • Yola göre gezin: find_child_by_name(), resolve_path()
  • Düğümleri incele: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
  • Konteynerleri yaz: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

MSG Dosya Okuma ve Yazma

MSG alt sistemi, CFB üzerine Outlook mesaj formatını işler.

SınıfAmaç
msg_readerMSG dosyalarını aç ve ayrıştır
msg_writerMSG belgelerini serileştir
msg_documentBir MSG dosyasının bellek içi temsili

Temel işlemler:

  • MSG dosyalarını aç: msg_reader::from_file(), msg_reader::from_stream()
  • Meta verileri incele: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
  • MSG dosyalarını yaz: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
  • CFB’ye dönüştür: msg_document::to_cfb_document() düşük seviyeli CFB erişimi için

Yüksek Düzey MAPI Mesaj API

mapi_message sınıfı, e-posta mesajları oluşturmak, okumak ve dönüştürmek için yüksek seviyeli bir arayüz sağlar.

Mesaj oluşturma:

  • mapi_message::create() — konu ve gövde ile yeni bir mesaj oluştur
  • set_subject(), set_body(), set_html_body() — mesaj içeriğini ayarla
  • set_sender_name(), set_sender_email_address(), set_sender_address_type() — göndereni ayarla
  • set_internet_message_id() — Message-ID başlığını ayarla
  • set_message_class() — MAPI mesaj sınıfını ayarla
  • unicode_strings() / set_unicode_strings() — Unicode dize kodlamasını kontrol et

Mesajlar yükleniyor:

  • mapi_message::from_file() — bir dosya yolundan yükle
  • mapi_message::from_stream() — bir giriş akışından yükle
  • mapi_message::from_msg_document() — bir msg_document‘den yükle

Mesajları kaydetme:

  • save() — baytlara, akışa veya dosyaya serileştir
  • to_msg_document() — düşük seviyeli erişim için bir msg_document‘e dönüştür

Ekler:

  • mapi_attachment::from_bytes(), mapi_attachment::from_stream() — ek dosya verisini yükle
  • mapi_attachment::is_embedded_message() — ekin gömülü bir MSG olup olmadığını kontrol et
  • mapi_attachment::load_data() — ek içeriğini tembel yükle

MAPI özellikleri:

  • mapi_property::property_id(), property_type(), property_tag() — özellik tanımlama
  • mapi_property::set_value(), flags(), set_flags() — özellik manipülasyonu
  • mapi_property_collection::remove() — bir koleksiyondan özellikleri kaldırma

EML ve MIME Dönüştürme

Outlook MSG formatı ile standart EML (RFC 5322 / MIME) arasında dönüştürme:

  • mapi_message::load_from_eml() — bir .eml dosyasını mapi_message‘a ayrıştır
  • mapi_message::save_to_eml() — bir mapi_message‘ı EML formatına serileştir

Konu, gövde, gönderici, alıcılar ve ekler dönüş yolculukları boyunca korunur.


Enum’lar ve Sabitler

EnumAmaç
common_message_property_idStandart MAPI özellik tanımlayıcıları (konu, gövde, gönderen, ekler)
property_type_codeMAPI özellik tür kodları (tam sayı, dize, ikili, zaman, GUID)
msg_storage_roleMSG dosyalarındaki depolama rolleri (mesaj, alıcı, ek)
directory_object_typeCFB dizin girişi türleri (depolama, akış, kök)
directory_color_flagCFB dizin girişleri için kırmızı-siyah ağaç renk bayrakları
sector_markerCFB dosya tahsis tablolarındaki özel sektör değerleri
 Türkçe