Funcionalitats

Visió general de la característica

Aspose.Email FOSS for C++ proporciona una API en capes per treballar amb fitxers Outlook MSG i contenidors Compound File Binary (CFB). La biblioteca té 26 classes públiques en dos subsystems: CFB i MSG/MAPI.


Accés al contenidor CFB

El subsistema CFB llegeix i escriu el format Microsoft Compound File Binary — el format de contenidor subjacient als fitxers Outlook .msg.

ClassePropòsit
cfb_readerObrir i recórrer fitxers CFB existents
cfb_writerSerialitzar documents CFB a bytes o fitxers
cfb_documentRepresentació en memòria d’un fitxer CFB
cfb_nodeNode individual d’emmagatzematge o flux a l’arbre de directoris
cfb_storageEntrada d’emmagatzematge amb nom
cfb_streamFlux amb nom amb dades binàries

Operacions clau:

  • Obre des de fitxer, flux o bytes: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
  • Enumera el contingut: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
  • Navega per ruta: find_child_by_name(), resolve_path()
  • Inspecciona nodes: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
  • Escriu contenidors: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

Lectura i escriptura de fitxer MSG

El subsistema MSG gestiona el format de missatge d’Outlook sobre CFB.

ClassePropòsit
msg_readerObrir i analitzar fitxers MSG
msg_writerSerialitzar documents MSG
msg_documentRepresentació en memòria d’un fitxer MSG

Operacions clau:

  • Obrir fitxers MSG: msg_reader::from_file(), msg_reader::from_stream()
  • Inspeccionar metadades: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
  • Escriure fitxers MSG: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
  • Convertir a CFB: msg_document::to_cfb_document() per a accés CFB de baix nivell

API de missatge MAPI d’alt nivell

La classe mapi_message ofereix una interfície d’alt nivell per crear, llegir i convertir missatges de correu electrònic.

Creació de missatges:

  • mapi_message::create() — crea un missatge nou amb assumpte i cos
  • set_subject(), set_body(), set_html_body() — estableix el contingut del missatge
  • set_sender_name(), set_sender_email_address(), set_sender_address_type() — estableix l’emissor
  • set_internet_message_id() — estableix la capçalera Message-ID
  • set_message_class() — estableix la classe de missatge MAPI
  • unicode_strings() / set_unicode_strings() — controla la codificació de cadenes Unicode

Carregant missatges:

  • mapi_message::from_file() — carregar des d’un camí de fitxer
  • mapi_message::from_stream() — carregar des d’un flux d’entrada
  • mapi_message::from_msg_document() — carregar des d’un msg_document

Desant missatges:

  • save() — serialitzar a bytes, flux o fitxer
  • to_msg_document() — convertir a un msg_document per a accés de baix nivell

Adjuncions:

  • mapi_attachment::from_bytes(), mapi_attachment::from_stream() — carregar les dades de l’adjunt
  • mapi_attachment::is_embedded_message() — comprovar si l’adjunt és un MSG incrustat
  • mapi_attachment::load_data() — carregar de forma pregona el contingut de l’adjunt

Propietats MAPI:

  • mapi_property::property_id(), property_type(), property_tag() — identificació de propietats
  • mapi_property::set_value(), flags(), set_flags() — manipulació de propietats
  • mapi_property_collection::remove() — eliminar propietats d’una col·lecció

Conversió d’EML i MIME

Convertir entre el format Outlook MSG i l’EML estàndard (RFC 5322 / MIME):

  • mapi_message::load_from_eml() — analitza un fitxer .eml en un mapi_message
  • mapi_message::save_to_eml() — serialitza un mapi_message al format EML

L’assumpte, el cos, l’emissor, els destinataris i els fitxers adjunts es conserven durant els viatges d’anada i tornada.


Enums i constants

EnumPropòsit
common_message_property_idIdentificadors de propietats MAPI estàndard (assumpte, cos, remitent, adjunts)
property_type_codeCodis de tipus de propietat MAPI (enter, cadena, binari, temps, GUID)
msg_storage_roleRols d’emmagatzematge dins dels fitxers MSG (missatge, destinatari, adjunt)
directory_object_typeTipus d’entrada de directori CFB (emmagatzematge, flux, arrel)
directory_color_flagIndicadors de color d’arbre vermell-negre per a les entrades de directori CFB
sector_markerValors especials de sector a les taules d’assignació de fitxers CFB
 Català