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.
| Classe | Propòsit |
|---|---|
cfb_reader | Obrir i recórrer fitxers CFB existents |
cfb_writer | Serialitzar documents CFB a bytes o fitxers |
cfb_document | Representació en memòria d’un fitxer CFB |
cfb_node | Node individual d’emmagatzematge o flux a l’arbre de directoris |
cfb_storage | Entrada d’emmagatzematge amb nom |
cfb_stream | Flux 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.
| Classe | Propòsit |
|---|---|
msg_reader | Obrir i analitzar fitxers MSG |
msg_writer | Serialitzar documents MSG |
msg_document | Representació 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 cosset_subject(),set_body(),set_html_body()— estableix el contingut del missatgeset_sender_name(),set_sender_email_address(),set_sender_address_type()— estableix l’emissorset_internet_message_id()— estableix la capçalera Message-IDset_message_class()— estableix la classe de missatge MAPIunicode_strings()/set_unicode_strings()— controla la codificació de cadenes Unicode
Carregant missatges:
mapi_message::from_file()— carregar des d’un camí de fitxermapi_message::from_stream()— carregar des d’un flux d’entradamapi_message::from_msg_document()— carregar des d’unmsg_document
Desant missatges:
save()— serialitzar a bytes, flux o fitxerto_msg_document()— convertir a unmsg_documentper a accés de baix nivell
Adjuncions:
mapi_attachment::from_bytes(),mapi_attachment::from_stream()— carregar les dades de l’adjuntmapi_attachment::is_embedded_message()— comprovar si l’adjunt és un MSG incrustatmapi_attachment::load_data()— carregar de forma pregona el contingut de l’adjunt
Propietats MAPI:
mapi_property::property_id(),property_type(),property_tag()— identificació de propietatsmapi_property::set_value(),flags(),set_flags()— manipulació de propietatsmapi_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.emlen unmapi_messagemapi_message::save_to_eml()— serialitza unmapi_messageal 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
| Enum | Propòsit |
|---|---|
common_message_property_id | Identificadors de propietats MAPI estàndard (assumpte, cos, remitent, adjunts) |
property_type_code | Codis de tipus de propietat MAPI (enter, cadena, binari, temps, GUID) |
msg_storage_role | Rols d’emmagatzematge dins dels fitxers MSG (missatge, destinatari, adjunt) |
directory_object_type | Tipus d’entrada de directori CFB (emmagatzematge, flux, arrel) |
directory_color_flag | Indicadors de color d’arbre vermell-negre per a les entrades de directori CFB |
sector_marker | Valors especials de sector a les taules d’assignació de fitxers CFB |