Ö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ıf | Amaç |
|---|---|
cfb_reader | Mevcut CFB dosyalarını aç ve dolaş |
cfb_writer | CFB belgelerini baytlara veya dosyalara serileştir |
cfb_document | Bir CFB dosyasının bellek içi temsili |
cfb_node | Dizin ağacındaki bireysel depolama veya akış düğümü |
cfb_storage | Adlandı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ıf | Amaç |
|---|---|
msg_reader | MSG dosyalarını aç ve ayrıştır |
msg_writer | MSG belgelerini serileştir |
msg_document | Bir 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şturset_subject(),set_body(),set_html_body()— mesaj içeriğini ayarlaset_sender_name(),set_sender_email_address(),set_sender_address_type()— göndereni ayarlaset_internet_message_id()— Message-ID başlığını ayarlaset_message_class()— MAPI mesaj sınıfını ayarlaunicode_strings()/set_unicode_strings()— Unicode dize kodlamasını kontrol et
Mesajlar yükleniyor:
mapi_message::from_file()— bir dosya yolundan yüklemapi_message::from_stream()— bir giriş akışından yüklemapi_message::from_msg_document()— birmsg_document‘den yükle
Mesajları kaydetme:
save()— baytlara, akışa veya dosyaya serileştirto_msg_document()— düşük seviyeli erişim için birmsg_document‘e dönüştür
Ekler:
mapi_attachment::from_bytes(),mapi_attachment::from_stream()— ek dosya verisini yüklemapi_attachment::is_embedded_message()— ekin gömülü bir MSG olup olmadığını kontrol etmapi_attachment::load_data()— ek içeriğini tembel yükle
MAPI özellikleri:
mapi_property::property_id(),property_type(),property_tag()— özellik tanımlamamapi_property::set_value(),flags(),set_flags()— özellik manipülasyonumapi_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.emldosyasınımapi_message‘a ayrıştırmapi_message::save_to_eml()— birmapi_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
| Enum | Amaç |
|---|---|
common_message_property_id | Standart MAPI özellik tanımlayıcıları (konu, gövde, gönderen, ekler) |
property_type_code | MAPI özellik tür kodları (tam sayı, dize, ikili, zaman, GUID) |
msg_storage_role | MSG dosyalarındaki depolama rolleri (mesaj, alıcı, ek) |
directory_object_type | CFB dizin girişi türleri (depolama, akış, kök) |
directory_color_flag | CFB dizin girişleri için kırmızı-siyah ağaç renk bayrakları |
sector_marker | CFB dosya tahsis tablolarındaki özel sektör değerleri |