Introdução

Trabalhar com arquivos MSG do Outlook em C++ historicamente exigia automação COM somente para Windows ou bibliotecas de terceiros pesadas com licenças restritivas. Aspose.Email FOSS for C ++ muda isso: é uma biblioteca pura de C +++17 sem dependências externas, sem COM e nenhum código específico da plataforma. Ele se baseia idênticamente no Linux, macOS e Windows.

A biblioteca é lançada sob a licença MIT e distribuída como fonte via GitHub. Você integra-a clonando o repositório e adicionando-o como um subdiretório CMake nenhum registro de gerenciador de pacotes é necessário, e não há necessidade de pré-criar binários.

Este post percorre o fluxo de trabalho principal: ler um arquivo MSG existente, inspecionar suas propriedades, criar uma nova mensagem programaticamente e fazer viagens entre os formatos MS G e EML.

Características principais

Leia arquivos MSG existentes

Utilização: msg_reader para abrir um .msg Arquivo e msg_document para aceder ao seu conteúdo estruturado. As duas classes vivem no interior da Comunidade. aspose::email::foss::msg Espaço de nomes.

#include "aspose/email/foss/msg/msg_reader.hpp"
#include "aspose/email/foss/msg/msg_document.hpp"
#include <filesystem>

namespace aef = aspose::email::foss;

auto reader   = aef::msg::msg_reader::from_file(std::filesystem::path("message.msg"));
auto document = aef::msg::msg_document::from_reader(reader);

msg_reader também tem um from_stream sobrecarga para leitura de um std::istream, que é útil em contextos do lado do servidor ou pipeline onde os arquivos não estão presentes no disco.

Criar mensagens programaticamente

mapi_message::create Produza uma nova mensagem na memória com um assunto e corpo. pode então definir os detalhes do remetente, adicionar destinatários e anexar cargas binárias ou texto antes de A salvar.

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

namespace aef = aspose::email::foss;

auto msg = aef::msg::mapi_message::create(
    "Quarterly status update",
    "Hello team,\n\nPlease find the rollout summary attached.\n\nRegards");

msg.set_sender_name("Build Agent");
msg.set_sender_email_address("build.agent@example.com");
msg.add_recipient("alice@example.com", "Alice Example");
msg.save(std::filesystem::path("output.msg"));

Conversão de MSG em EML

mapi_message Apoia a conversão directa de MSG em EML através da save_to_eml método. A saída EML está em conformidade com a RFC 5322 (MIME), tornando-a compatível com qualquer e-mail padrão. cliente ou do condutor de processamento.

auto loaded = aef::msg::mapi_message::from_file(
    std::filesystem::path("message.msg"), /*strict=*/false);

// Save as EML to a file
loaded.save_to_eml(std::filesystem::path("message.eml"));

// Or capture as bytes
std::vector<std::uint8_t> eml_bytes = loaded.save_to_eml();

Carga do EML

A direcção inversa é igualmente simples: load_from_eml Leia um ficheiro EML. e produz uma mapi_message na memória, que pode ser guardada de volta para o MSG.

auto from_eml = aef::msg::mapi_message::load_from_eml(
    std::filesystem::path("message.eml"));

from_eml.save(std::filesystem::path("restored.msg"));

Acesso CFB de baixo nível

Para casos de utilização avançados tais como a leitura das propriedades MAPI brutas não expostas pelo sistema de análise da qualidade. API de alto nível cfb_reader dá acesso direto ao contêiner Compound File Binary que sustenta o formato do GMS.

#include "aspose/email/foss/cfb/cfb_reader.hpp"

namespace aef = aspose::email::foss;

auto cfb = aef::cfb::cfb_reader::from_file(std::filesystem::path("message.msg"));
auto storage_ids = cfb.storage_ids();
auto stream_ids  = cfb.stream_ids();

Começo rápido

Passo 1 Clone e Adicionar como Subdirectório

git clone https://github.com/aspose-email-foss/Aspose.Email-FOSS-for-Cpp.git

No seu projecto. CMakeLists.txt:

cmake_minimum_required(VERSION 3.26)
project(my_project)

add_subdirectory(Aspose.Email-FOSS-for-Cpp)

add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE AsposeEmailFoss::AsposeEmailFoss)

Passo 2 Incluir e utilizar

#include <iostream>
#include "aspose/email/foss/msg/mapi_message.hpp"

namespace aef = aspose::email::foss;

int main()
{
    // Create a message
    auto msg = aef::msg::mapi_message::create("Hello from C++", "Body text here");
    msg.save(std::filesystem::path("hello.msg"));

    // Round-trip to EML
    auto loaded = aef::msg::mapi_message::from_file(
        std::filesystem::path("hello.msg"), false);
    loaded.save_to_eml(std::filesystem::path("hello.eml"));

    std::cout << "Done\n";
}

Passo 3 Construir

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

Formatos suportados

Formatos de imagemExtensãoLeia.Escrever .
MSG (Mensagem de perspectiva).msg✓✓
EML (RFC 5322 / MIME).eml✓✓
CFB (Compound File Binary).msg, .cfb✓✓

Open Source & Licenciamento

Aspose.Email FOSS for C++ is released under the MIT license. The full source is available no GitHub em: Associação de Empregadores da União Europeia (UE) - Comissão dos Direitos do Homem e das Mulheres.. O uso comercial é permitido sem royalties. A biblioteca não tem dependências de tempo de execução além de um compilador C++17 e CMake 3.26 ou posterior.

Começar a Fazer