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

libpff

 
 

Open source C-bibliotek til Outlook-filformater

Læs, parse og udtræk data fra PST-, OST-, PAB- og OFF-filer via gratis open source C API.

Hvad er libpff?

libpff er et kraftfuldt open source C-bibliotek designet til at få adgang til Personal Folder File (PFF) og Offline Folder File (OFF) formater, som bruges af Microsoft Outlook. Det gør det muligt for udviklere at læse, parse og udtrække e‑mail, kontakter, kalenderposter og andre data gemt i PST-, OST-, PAB- og OFF-filer programmatisk. Biblioteket understøtter både 32-bit ANSI- og 64-bit Unicode-tegnkodninger samt komprimerede formater som 4K-side DEFLATE-komprimerede OST-filer, der blev introduceret i Outlook 2013. Med sin robuste parse‑motor er libpff især værdifuldt i digitale retsmedicinske undersøgelser, e‑mail-migrering og datarekonstruktionsarbejdsgange.

Biblioteket vedligeholdes aktivt under LGPL-3.0-eller-senere-licensen og er i øjeblikket处于 alpha status, hvilket betyder, at det er funktionelt, men kan mangle fuld funktionsfuldstændighed eller stabilitet til produktionsbrug. Det inkluderer værktøjer til genoprettelse af elementer og kan håndtere korrupte eller krypterede filer, hvor krypteringstypen er ingen. libpff integrerer også med relaterede projekter som libfmapi for MAPI-definitioner og leverer detaljeret retsmedicinsk dokumentation for at hjælpe med at analysere komplekse Outlook-filstrukturer. Udviklere kan bygge fra kildekode eller bruge forkompilerede binære filer, og projektet er hostet på GitHub for fællesskabsbidrag og fejlsporing.

Previous Next

Kom i gang med libpff

For at begynde at bruge libpff, kan du klone kildekoden fra det officielle [libpff GitHub](https://github.com/libyal/libpff) repository og bygge den ved hjælp af CMake eller autotools. Forudkompilerede binære filer distribueres ikke officielt, så bygning fra kildekode er den anbefalede tilgang. Projektet indeholder detaljerede byggevejledninger og afhængigheder som libyal/libcerror og libyal/libcdata. Når den er bygget, kan du bruge de medfølgende kommandolinjeværktøjer (f.eks. `pffexport`, `pffinfo`) til at inspicere og udtrække data fra PST/OST-filer. Til programmatisk brug kan du linke mod det kompilerede bibliotek i din C/C++-applikation. Biblioteket er letvægts og har minimale eksterne afhængigheder, hvilket gør det velegnet til indlejrede eller retsmedicinske miljøer.

Installer libpff via kildekodebygning

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

Udtræk e-mails og vedhæftede filer fra PST-filer

libpff leverer robust funktionalitet til at parse PST-filer og udtrække individuelle e-mailbeskeder sammen med deres vedhæftede filer. Udviklere kan gennemløbe mappehierarkiet, få adgang til beskedegenskaber (f.eks. emne, afsender, modtagere, tidsstempler) og eksportere rå MIME-indhold eller strukturerede data. Biblioteket understøtter både ANSI- og Unicode-tegnkodninger, hvilket sikrer kompatibilitet med Outlook-versioner fra 1990'erne og frem til moderne udgivelser. Det håndterer også komprimerede OST-filer (4K-side DEFLATE), som er almindelige i nyere Outlook-versioner. Dette gør libpff ideelt til e-mailmigrationsværktøjer, e-discovery-platforme og retsmedicinsk analyse, hvor præcis udtrækning af beskedkroppe og vedhæftede filer er kritisk. API'en giver lavniveauadgang til MAPI-egenskaber, hvilket muliggør finjusteret kontrol over datahentning.

Hvordan udtrækker man e-mails fra en PST-fil via 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);

Retsmedicinsk analyse af korrupte Outlook-filer

libpff inkluderer specialiserede funktioner til retsmedicinsk analyse af beskadigede eller delvist korrupte Outlook-filer. Den kan parse filer med manglende eller inkonsistente headers, gendanne forældreløse elementer og rekonstruere beskedtræer selv når interne indekser er ødelagte. Biblioteket understøtter filer med krypteringstype "none" og kan omgå visse strukturelle fejl for at udtrække brugbare data. Dette er især værdifuldt i digitale retsmedicinske undersøgelser, hvor beviser kan ligge i nedbrudte PST/OST-filer. libpff leverer også detaljeret logning og fejlrapportering, så analytikere kan spore parsebeslutninger og identificere datatabspunkter. Kombineret med dens MAPI‑egenskabsudtræk fungerer libpff som et pålideligt grundlag for at bygge retsmedicinske værktøjer, der opfylder lovmæssige og compliance‑standarder.

Hvordan gendanner man elementer fra en beskadiget PST-fil?

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

Analyser MAPI-egenskaber og metadata

libpff muliggør dyb inspektion af MAPI‑egenskaber indlejret i Outlook‑elementer. Udviklere kan hente standardegenskaber som `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME` og brugerdefinerede egenskaber defineret af applikationer. Biblioteket eksponerer et egenskabssæt‑API, der tillader iteration over alle egenskaber i en besked, mappe eller vedhæftning. Dette er essentielt for applikationer, der kræver overholdelsesrevision, metadataudtræk eller integration med MAPI‑baserede systemer. libpff understøtter både navngivne og numeriske egenskabsidentifikatorer og håndterer både 32‑bit og 64‑bit værdityper (f.eks. strenge, heltal, binære blobber). Dens tætte integration med libfmapi sikrer nøjagtig fortolkning af MAPI‑definitioner, hvilket gør den egnet til at bygge avancerede Outlook‑dataanalyseværktøjer.

Hvordan udtrækker man MAPI-egenskaber fra et meddelelseselement?

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

Eksporter data til standardformater (CSV, JSON, XML)

Mens libpff primært er et C-bibliotek til lavniveau-parsing, inkluderer det kommandolinjeværktøjer og API'er, der letter eksport af Outlook-data til bredt anvendte formater som CSV, JSON og XML. Værktøjer som `pffexport` kan konvertere PST/OST-indhold til strukturerede tekstfiler, som bevarer mappehierarki og beskedmetadata. Udviklere kan også bruge biblioteket programmatisk til at bygge tilpassede eksportører—f.eks. kortlægning af MAPI-egenskaber til JSON-objekter for indtagelse i søgemaskiner eller analyseplatforme. Denne eksportfunktion er afgørende for datamigrering, sikkerhedskopiering og integration med moderne cloud-tjenester, der kræver standardiserede inputformater. libpff's fleksible design gør det muligt for udviklere at tilpasse eksportlogik til specifikke overholdelses- eller arbejdsflowkrav.

Hvordan eksporterer man PST-indhold til 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
 Dansk