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

libpff

 
 

Open source C-bibliotheek voor Outlook-bestandsformaten

Lees, parseer en extraheer gegevens uit PST-, OST-, PAB- en OFF-bestanden via gratis open source C-API.

Wat is libpff?

libpff is een krachtige open source C-bibliotheek ontworpen om toegang te krijgen tot Personal Folder File (PFF) en Offline Folder File (OFF) formaten die door Microsoft Outlook worden gebruikt. Het stelt ontwikkelaars in staat om programmatisch e‑mail, contactpersonen, agenda‑items en andere gegevens die zijn opgeslagen in PST-, OST-, PAB- en OFF‑bestanden te lezen, te parseren en te extraheren. De bibliotheek ondersteunt zowel 32‑bit ANSI- als 64‑bit Unicode‑tekencoderingen, evenals gecomprimeerde formaten zoals 4K‑pagina DEFLATE‑gecomprimeerde OST‑bestanden die werden geïntroduceerd in Outlook 2013. Met zijn robuuste parseringsengine is libpff vooral waardevol in digitale forensische onderzoeken, e‑mailmigratie en gegevensherstel‑werkstromen.

De bibliotheek wordt actief onderhouden onder de LGPL-3.0-or-later licentie en bevindt zich momenteel处于 alpha status, wat betekent dat hij functioneel is maar mogelijk niet volledig feature-compleet of stabiel genoeg voor productiegebruik. Hij bevat tools voor itemherstel en kan corrupte of versleutelde bestanden verwerken waarbij het versleuteltype geen is. libpff integreert ook met gerelateerde projecten zoals libfmapi voor MAPI-definities en biedt gedetailleerde forensische documentatie om complexe Outlook-bestandsstructuren te analyseren. Ontwikkelaars kunnen vanuit de bron bouwen of vooraf gecompileerde binaries gebruiken, en het project wordt gehost op GitHub voor communitybijdragen en issue-tracking.

Previous Next

Aan de slag met libpff

Om libpff te gaan gebruiken, kun je de broncode klonen van de officiële [libpff GitHub](https://github.com/libyal/libpff) repository en deze bouwen met CMake of autotools. Voorgecompileerde binaries worden niet officieel verspreid, dus bouwen vanaf de bron is de aanbevolen aanpak. Het project bevat gedetailleerde bouwinstructies en afhankelijkheden zoals libyal/libcerror en libyal/libcdata. Zodra het is gebouwd, kun je de meegeleverde commandoregeltools (bijv. `pffexport`, `pffinfo`) gebruiken om PST/OST‑bestanden te inspecteren en gegevens te extraheren. Voor programmatisch gebruik link je tegen de gecompileerde bibliotheek in je C/C++‑applicatie. De bibliotheek is lichtgewicht en heeft minimale externe afhankelijkheden, waardoor hij geschikt is voor embedded of forensische omgevingen.

Installeer libpff via bronbuild

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

E-mails en bijlagen extraheren uit PST-bestanden

libpff biedt robuuste functionaliteit om PST-bestanden te parseren en individuele e-mailberichten samen met hun bijlagen te extraheren. Ontwikkelaars kunnen de maphiërarchie doorlopen, berichteigenschappen (bijv. onderwerp, afzender, ontvangers, tijdstempels) openen en ruwe MIME-inhoud of gestructureerde gegevens exporteren. De bibliotheek ondersteunt zowel ANSI- als Unicode-tekenencoderingen, waardoor compatibiliteit met Outlook‑versies vanaf de jaren 1990 tot moderne releases wordt gegarandeerd. Het verwerkt ook gecomprimeerde OST‑bestanden (4K‑pagina DEFLATE), die vaak voorkomen in nieuwere Outlook‑versies. Dit maakt libpff ideaal voor e‑mailmigratietools, e‑discoveryplatforms en forensische analyse waar nauwkeurige extractie van berichtlichamen en bijlagen cruciaal is. De API biedt low‑level toegang tot MAPI‑eigenschappen, waardoor fijnmazige controle over gegevensophaling mogelijk is.

Hoe e-mails extraheren uit een PST-bestand via de C-API?

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);

Forensische analyse van beschadigde Outlook-bestanden

libpff bevat gespecialiseerde mogelijkheden voor forensische analyse van beschadigde of gedeeltelijk corrupte Outlook‑bestanden. Het kan bestanden met ontbrekende of inconsistente headers parseren, verweesde items herstellen en berichtbomen reconstrueren, zelfs wanneer interne indexen kapot zijn. De bibliotheek ondersteunt bestanden met encryptietype "none" en kan bepaalde structurele fouten omzeilen om bruikbare gegevens te extraheren. Dit is vooral waardevol bij digitale forensische onderzoeken waar bewijsmateriaal zich kan bevinden in verslechterde PST/OST‑bestanden. libpff biedt ook gedetailleerde logging en foutrapportage, waardoor analisten parsebeslissingen kunnen volgen en punten van gegevensverlies kunnen identificeren. In combinatie met de MAPI‑eigenschapsextractie vormt libpff een betrouwbare basis voor het bouwen van forensische tools die voldoen aan wettelijke en compliance‑normen.

Hoe items herstellen uit een beschadigd PST-bestand?

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);

MAPI-eigenschappen en metadata parseren

libpff maakt diepgaande inspectie van MAPI-eigenschappen mogelijk die in Outlook-items zijn ingebed. Ontwikkelaars kunnen standaardeigenschappen ophalen zoals `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, en aangepaste eigenschappen die door applicaties zijn gedefinieerd. De bibliotheek biedt een property set API die iteratie over alle eigenschappen van een bericht, map of bijlage mogelijk maakt. Dit is essentieel voor applicaties die compliance-auditing, metadata-extractie of integratie met MAPI-gebaseerde systemen vereisen. libpff ondersteunt zowel benoemde als numerieke eigenschapsidentifiers, en verwerkt zowel 32-bit als 64-bit waardetypen (bijv. strings, integers, binaire blobs). De nauwe integratie met libfmapi zorgt voor een nauwkeurige interpretatie van MAPI-definities, waardoor het geschikt is voor het bouwen van geavanceerde Outlook-gegevensanalyse-tools.

Hoe MAPI-eigenschappen extraheren uit een berichtitem?

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);
}

Gegevens exporteren naar standaardformaten (CSV, JSON, XML)

Hoewel libpff voornamelijk een C-bibliotheek is voor low-level parsing, bevat het commandoregelhulpmiddelen en API's die het exporteren van Outlook-gegevens naar veelgebruikte formaten zoals CSV, JSON en XML vergemakkelijken. Hulpmiddelen zoals `pffexport` kunnen PST/OST-inhoud omzetten naar gestructureerde tekstbestanden, waarbij de maphiërarchie en berichtmetadata behouden blijven. Ontwikkelaars kunnen de bibliotheek ook programmatisch gebruiken om aangepaste exporters te bouwen—bijv. MAPI-eigenschappen te mappen naar JSON-objecten voor invoer in zoekmachines of analyseplatformen. Deze exportmogelijkheid is cruciaal voor datamigratie, back‑up en integratie met moderne cloudservices die gestandaardiseerde invoerformaten vereisen. Het flexibele ontwerp van libpff stelt ontwikkelaars in staat om exportlogica af te stemmen op specifieke nalevings‑ of workflowvereisten.

Hoe PST-inhoud exporteren naar JSON via de 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
 Dutch