Caratteristiche

Panoramica delle funzionalità

Aspose.Email FOSS for C++ fornisce un’API a più livelli per lavorare con i file Outlook MSG e
contenitori Compound File Binary (CFB). La libreria dispone di 26 classi pubbliche distribuite su due
sottosistemi: CFB e MSG/MAPI.

Accesso al contenitore CFB

Il sottosistema CFB legge e scrive il formato Microsoft Compound File Binary — il formato container alla base dei file Outlook .msg.

Operazioni chiave:

• Apri da file, stream o byte: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
• Elenca contenuti: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
• Naviga per percorso: find_child_by_name(), resolve_path()
• Ispeziona nodi: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
• Scrivi contenitori: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

Lettura e scrittura di file MSG

Il sottosistema MSG gestisce il formato dei messaggi Outlook sopra CFB.

Operazioni chiave:

• Apri file MSG: msg_reader::from_file(), msg_reader::from_stream()
• Ispeziona i metadati: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
• Scrivi file MSG: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
• Converti in CFB: msg_document::to_cfb_document() per l’accesso a basso livello CFB

API di messaggi MAPI di alto livello

La classe mapi_message fornisce un’interfaccia di alto livello per creare, leggere e convertire i messaggi email.

Creazione dei messaggi:

• mapi_message::create() — crea un nuovo messaggio con oggetto e corpo
• set_subject(), set_body(), set_html_body() — imposta il contenuto del messaggio
• set_sender_name(), set_sender_email_address(), set_sender_address_type() — imposta il mittente
• set_internet_message_id() — imposta l’intestazione Message-ID
• set_message_class() — imposta la classe di messaggio MAPI
• unicode_strings() / set_unicode_strings() — controlla la codifica delle stringhe Unicode

Caricamento dei messaggi:

• mapi_message::from_file() — carica da un percorso file
• mapi_message::from_stream() — carica da un flusso di input
• mapi_message::from_msg_document() — carica da un msg_document

Salvataggio dei messaggi:

• save() — serializzare in byte, stream o file
• to_msg_document() — convertire in un msg_document per l’accesso a basso livello

Allegati:

• mapi_attachment::from_bytes(), mapi_attachment::from_stream() — caricare i dati dell’allegato
• mapi_attachment::is_embedded_message() — verificare se l’allegato è un MSG incorporato
• mapi_attachment::load_data() — caricare pigramente il contenuto dell’allegato

Proprietà MAPI:

• mapi_property::property_id(), property_type(), property_tag() — identificazione delle proprietà
• mapi_property::set_value(), flags(), set_flags() — manipolazione delle proprietà
• mapi_property_collection::remove() — rimuovere le proprietà da una raccolta

Conversione EML e MIME

Converti tra il formato Outlook MSG e lo standard EML (RFC 5322 / MIME):

• mapi_message::load_from_eml() — analizza un file .eml in un mapi_message
• mapi_message::save_to_eml() — serializza un mapi_message in formato EML

L’oggetto, il corpo, il mittente, i destinatari e gli allegati vengono preservati durante i round‑trip.

Enumerazioni e Costanti