1. Produtos
  2.   Aspose.Email
  3.   Aspose.Email FOSS for C++

Aspose.Email FOSS para C++

Leia, crie e processe arquivos Outlook MSG e contêineres CFB a partir de C++ — gratuito e de código aberto, sem dependência do Microsoft Outlook.

Aspose.Email FOSS for C++ Aspose.Email FOSS
for C++

Documentação GitHub

Biblioteca C++ Open-Source para arquivos MSG e CFB

Aspose.Email FOSS para C++ é uma biblioteca C++ de código aberto licenciada sob MIT, para trabalhar com arquivos .msg do Microsoft Outlook e contêineres Compound File Binary (CFB). Inclua os cabeçalhos via CMake e comece imediatamente a ler, criar e processar mensagens de e‑mail sem instalar o Microsoft Outlook ou qualquer runtime proprietário.

A biblioteca fornece dois níveis de acesso. No nível baixo, cfb_reader e cfb_writer dão controle total sobre contêineres binários CFB — percorrer entradas de diretório, ler e gravar nós de armazenamento e dados de fluxo, e inspecionar o layout bruto dos setores. msg_reader e msg_writer lidam com o formato MSG sobre CFB, expondo fluxos de propriedades MAPI, tabelas de destinatários e subarmazenamentos de anexos. No nível alto, mapi_message permite criar novas mensagens do zero, ler assuntos, corpos, destinatários e anexos, e converter entre os formatos MSG e EML. A biblioteca funciona em qualquer plataforma com um compilador C++17 e não tem dependências externas, tornando‑a adequada para Windows, Linux, macOS, contêineres Docker e sistemas embarcados. Uma edição empresarial com recursos adicionais é oferecida como Aspose.Email for C++.

Leitura e gravação de contêiner CFB

  • Abrir arquivos CFB: Carregue contêineres CFB existentes a partir de um caminho de arquivo, stream ou array de bytes via cfb_reader::from_file(), cfb_reader::from_stream() ou cfb_reader::from_bytes().
  • Percorra a árvore de diretórios: Enumere armazenamentos e fluxos usando storage_ids(), stream_ids() e child_ids(), e navegue em hierarquias aninhadas com resolve_path().
  • Inspecionar nós: Verifique o tipo de nó com cfb_node::is_storage() e cfb_node::is_stream(), leia timestamps via creation_time() e modified_time().
  • Escreva contêineres CFB: Crie documentos CFB programaticamente com cfb_document e serialize para bytes ou arquivo via cfb_writer::to_bytes() ou cfb_writer::write_file().

Onde CFB Access é Usado

  • Inspeção de arquivos MSG: CFB é o formato de contêiner para arquivos .msg do Outlook — o acesso direto ao CFB permite inspeção forense e reparo.
  • Custom binary formats: Qualquer aplicação legada que use CFB para armazenamento de dados pode ser lida ou escrita sem uma dependência COM.
  • Data recovery: Percorra toda a árvore de diretórios e extraia os bytes brutos do fluxo de arquivos CFB danificados ou não padrão.

Leitura e gravação de arquivo MSG

  • Ler arquivos MSG: Abra arquivos MSG do Outlook com msg_reader::from_file() ou msg_reader::from_stream() e acesse os fluxos de propriedades MAPI subjacentes e os subarmazenamentos de anexos.
  • Write MSG files: Produza arquivos MSG a partir de um msg_document com msg_writer::to_bytes() ou msg_writer::write_file().
  • Inspeção de documento MSG: Acesse os metadados da versão via msg_document::major_version(), msg_document::minor_version(), e verifique o rigor com msg_document::strict().
  • Converter para CFB: Extraia o documento CFB subjacente de um arquivo MSG via msg_document::to_cfb_document().

Onde o Processamento de MSG é Usado

  • Pipelines de arquivamento de e‑mail: Leitura em massa de arquivos .msg de diretórios de arquivo e extração de metadados ou anexos.
  • Ferramentas de migração: Converta coleções MSG para formatos padrão para importação em sistemas que não sejam Outlook.
  • Descoberta legal: Analise fluxos de propriedades MAPI brutos para extrair todos os campos de mensagem, incluindo propriedades não padrão.

API de Mensagens MAPI de Alto Nível

  • Criar mensagens: Construa um e‑mail completo com mapi_message::create(), em seguida, defina o assunto, o corpo e o corpo HTML via set_subject(), set_body() e set_html_body().
  • Definir detalhes do remetente: Configure set_sender_name(), set_sender_email_address() e set_sender_address_type() para a mensagem de saída.
  • Gerenciar anexos: Carregue anexos a partir de bytes ou streams com mapi_attachment::from_bytes() e mapi_attachment::from_stream(), e verifique mensagens incorporadas via is_embedded_message().
  • Salvar e recarregar: Serializar com mapi_message::save() e recarregar com mapi_message::from_file() ou mapi_message::from_stream().

Onde a API de Alto Nível é Usada

  • Geração automática de e‑mail: Gere milhares de arquivos MSG personalizados a partir de registros de dados em trabalhos em lote.
  • Criação de fixture de teste: Construa arquivos MSG conhecidos e corretos com conteúdo previsível para suítes de teste de integração.
  • Extração de anexos: Carregue um arquivo MSG, itere pelos anexos e salve cada um no disco.

Conversão de EML e MIME

  • Carregar EML em mapi_message: Analise um arquivo .eml padrão (RFC 5322 / MIME) em um objeto mapi_message completo via mapi_message::load_from_eml().
  • Salvar mapi_message como EML: Serializar um mapi_message de volta ao formato MIME com save_to_eml().
  • Fidelidade de ida e volta: Assunto, corpo, remetente, destinatários e anexos são preservados em viagens de ida e volta de EML para MSG para EML.

Onde a Conversão de EML é Usada

  • Format bridging: Receba e‑mails como EML dos servidores de correio e converta para MSG para armazenamento compatível com Outlook.
  • Conformidade com padrões: Converta arquivos MSG proprietários para MIME padrão para entrega a qualquer transporte de e‑mail.
  • Normalização de arquivamento: Normalizar um arquivo misto de arquivos .eml e .msg para um único formato.

Ler o Assunto de um Arquivo MSG

Abra um arquivo Outlook MSG a partir de um fluxo e imprima o assunto — sem necessidade do Microsoft Outlook.

#include <fstream>
#include <iostream>

#include "aspose/email/foss/msg/mapi_message.hpp"

int main()
{
    std::ifstream input("sample.msg", std::ios::binary);
    auto message = aspose::email::foss::msg::mapi_message::from_stream(input);
    std::cout << message.subject() << '\n';
}

Criar e Salvar uma Mensagem MSG

Crie um e‑mail completo com remetente, destinatário e anexo, e então grave‑o nos formatos MSG e EML.

#include <fstream>

#include "aspose/email/foss/msg/mapi_message.hpp"

int main()
{
    auto message = aspose::email::foss::msg::mapi_message::create("Hello", "Body");
    message.set_sender_name("Alice");
    message.set_sender_email_address("alice@example.com");
    message.add_recipient("bob@example.com", "Bob");
    message.add_attachment("note.txt", std::vector<std::uint8_t>{'a', 'b', 'c'}, "text/plain");

    std::ofstream msg_output("hello.msg", std::ios::binary);
    message.save(msg_output);

    std::ofstream eml_output("hello.eml", std::ios::binary);
    message.save_to_eml(eml_output);
}
  

Recursos de Suporte e Aprendizado

 Português