1. Produtos
  2.   E-mail
  3.   C++
  4.   libpff

libpff

 
 

Biblioteca C de Código Aberto para Formatos de Arquivo Outlook

Leia, Analise e Extraia Dados de Arquivos PST, OST, PAB e OFF via API C Gratuita e de Código Aberto.

O que é libpff?

libpff é uma poderosa biblioteca C de código aberto projetada para acessar os formatos Personal Folder File (PFF) e Offline Folder File (OFF) usados pelo Microsoft Outlook. Ela permite que desenvolvedores leiam, analisem e extraiam programaticamente e‑mail, contatos, itens de calendário e outros dados armazenados em arquivos PST, OST, PAB e OFF. A biblioteca suporta codificações de strings ANSI de 32 bits e Unicode de 64 bits, bem como formatos compactados, como arquivos OST comprimidos com DEFLATE de página de 4 KB introduzidos no Outlook 2013. Com seu robusto mecanismo de análise, libpff é especialmente valiosa em forense digital, migração de e‑mail e fluxos de trabalho de recuperação de dados.

A biblioteca é mantida ativamente sob a licença LGPL-3.0-or-later e atualmente处于 status alfa, significando que é funcional mas pode carecer de completude total de recursos ou estabilidade para uso em produção. Inclui ferramentas para recuperação de itens e pode lidar com arquivos corrompidos ou criptografados onde o tipo de criptografia é nenhum. libpff também se integra a projetos relacionados como libfmapi para definições MAPI e fornece documentação forense detalhada para ajudar a analisar estruturas complexas de arquivos Outlook. Desenvolvedores podem compilar a partir do código-fonte ou usar binários pré-compilados, e o projeto está hospedado no GitHub para contribuições da comunidade e rastreamento de issues.

Previous Next

Começando com libpff

Para começar a usar o libpff, você pode clonar o código-fonte do seu repositório oficial [libpff GitHub](https://github.com/libyal/libpff) e compilá-lo usando CMake ou autotools. Binários pré-compilados não são distribuídos oficialmente, portanto compilar a partir do código-fonte é a abordagem recomendada. O projeto inclui instruções detalhadas de compilação e dependências como libyal/libcerror e libyal/libcdata. Depois de compilado, você pode usar as ferramentas de linha de comando fornecidas (por exemplo, `pffexport`, `pffinfo`) para inspecionar e extrair dados de arquivos PST/OST. Para uso programático, vincule-se à biblioteca compilada em sua aplicação C/C++. A biblioteca é leve e tem dependências externas mínimas, tornando-a adequada para ambientes embarcados ou forenses.

Instalar libpff via compilação a partir do código fonte

git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install

Extrair e‑mails e anexos de arquivos PST

libpff fornece funcionalidade robusta para analisar arquivos PST e extrair mensagens de email individuais juntamente com seus anexos. Os desenvolvedores podem percorrer a hierarquia de pastas, acessar propriedades das mensagens (por exemplo, assunto, remetente, destinatários, carimbos de tempo) e exportar conteúdo MIME bruto ou dados estruturados. A biblioteca suporta codificações de strings ANSI e Unicode, garantindo compatibilidade com versões do Outlook desde a década de 1990 até lançamentos modernos. Também lida com arquivos OST compactados (DEFLATE de página de 4K), que são comuns em versões mais recentes do Outlook. Isso torna o libpff ideal para ferramentas de migração de email, plataformas de e-discovery e análise forense, onde a extração precisa dos corpos das mensagens e anexos é crítica. A API expõe acesso de baixo nível às propriedades MAPI, permitindo controle granular sobre a recuperação de dados.

Como extrair e‑mails de um arquivo PST via API C?

pff_file_t *pff_file = NULL;
pff_error_t *error = NULL;

if (pff_file_open(&pff_file, "example.pst", PFF_OPEN_READ, &error) != 1) {
    // handle error
}

pff_item_t *root_item = NULL;
if (pff_file_get_root_item(pff_file, &root_item, &error) != 1) {
    // handle error
}

// Iterate over items and extract messages
pff_item_t *item = NULL;
while (pff_item_get_sub_item(root_item, &item, &error) == 1) {
    // Process each item (e.g., folder or message)
    pff_item_free(&item, NULL);
}
pff_item_free(&root_item, NULL);
pff_file_close(pff_file, &error);

Análise forense de arquivos Outlook corrompidos

libpff inclui recursos especializados para análise forense de arquivos Outlook danificados ou parcialmente corrompidos. Ele pode analisar arquivos com cabeçalhos ausentes ou inconsistentes, recuperar itens órfãos e reconstruir árvores de mensagens mesmo quando os índices internos estão quebrados. A biblioteca suporta arquivos com tipo de criptografia "none" e pode contornar certos erros estruturais para extrair dados utilizáveis. Isso é especialmente valioso em investigações de forense digital onde evidências podem residir em arquivos PST/OST degradados. libpff também fornece registro detalhado e relatórios de erros, permitindo que analistas acompanhem decisões de análise e identifiquem pontos de perda de dados. Combinado com sua extração de propriedades MAPI, libpff serve como uma base confiável para construir ferramentas forenses que atendam a padrões legais e de conformidade.

Como recuperar itens de um arquivo PST corrompido?

pff_file_t *pff_file = NULL;
pff_error_t *error = NULL;

// Open with recovery mode (if supported)
if (pff_file_open_recover(&pff_file, "corrupted.pst", PFF_OPEN_READ, &error) != 1) {
    // fallback to standard open
    pff_file_open(&pff_file, "corrupted.pst", PFF_OPEN_READ, &error);
}

// Use item recovery functions
pff_item_t *recovered_item = NULL;
if (pff_file_get_recovered_item(pff_file, &recovered_item, &error) == 1) {
    // Process recovered item
    pff_item_free(&recovered_item, NULL);
}
pff_file_close(pff_file, &error);

Analisar propriedades e metadados MAPI

libpff permite inspeção profunda das propriedades MAPI incorporadas em itens do Outlook. Os desenvolvedores podem recuperar propriedades padrão como `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, e propriedades personalizadas definidas por aplicações. A biblioteca expõe uma API de conjunto de propriedades que permite iterar sobre todas as propriedades de uma mensagem, pasta ou anexo. Isso é essencial para aplicações que requerem auditoria de conformidade, extração de metadados ou integração com sistemas baseados em MAPI. libpff suporta tanto identificadores de propriedades nomeados quanto numéricos, e lida com tipos de valor de 32 bits e 64 bits (por exemplo, strings, inteiros, blobs binários). Sua integração estreita com libfmapi garante interpretação precisa das definições MAPI, tornando-a adequada para construir ferramentas avançadas de análise de dados do Outlook.

Como extrair propriedades MAPI de um item de mensagem?

pff_item_t *message_item = NULL;
pff_property_t *property = NULL;
pff_error_t *error = NULL;

// Assume message_item is obtained from traversal
while (pff_item_get_property(message_item, &property, &error) == 1) {
    uint32_t property_tag = 0;
    uint32_t property_type = 0;
    const uint8_t *value_data = NULL;
    size_t value_data_size = 0;

    pff_property_get_tag(property, &property_tag, &error);
    pff_property_get_type(property, &property_type, &error);
    pff_property_get_value_data(property, &value_data, &value_data_size, &error);

    // Process property (e.g., print subject if PR_SUBJECT)
    if (property_tag == 0x0037001F) { // PR_SUBJECT (Unicode)
        printf("Subject: %ls\n", (wchar_t*)value_data);
    }
    pff_property_free(&property, NULL);
}

Exportar dados para formatos padrão (CSV, JSON, XML)

Embora o libpff seja principalmente uma biblioteca C para análise de baixo nível, inclui utilitários de linha de comando e APIs que facilitam a exportação de dados do Outlook para formatos amplamente usados como CSV, JSON e XML. Ferramentas como `pffexport` podem converter o conteúdo de PST/OST em arquivos de texto estruturados, preservando a hierarquia de pastas e os metadados das mensagens. Os desenvolvedores também podem usar a biblioteca programaticamente para criar exportadores personalizados—por exemplo, mapeando propriedades MAPI para objetos JSON para ingestão em mecanismos de busca ou plataformas de análise. Essa capacidade de exportação é crucial para migração de dados, backup e integração com serviços de nuvem modernos que exigem formatos de entrada padronizados. O design flexível do libpff permite que os desenvolvedores adaptem a lógica de exportação a requisitos específicos de conformidade ou fluxo de trabalho.

Como exportar o conteúdo do PST para JSON via CLI?

# Export all messages to JSON with metadata
pffexport -f json -o output_dir/ example.pst

# Export only messages with attachments
pffexport -f json -a example.pst

# View help for export options
pffexport --help
 Português