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

libpff

 
 

Åpen kildekode C-bibliotek for Outlook-filformater

Les, analyser og hent ut data fra PST-, OST-, PAB- og OFF-filer via gratis åpen kildekode C-API.

Hva er libpff?

libpff er et kraftig åpen kildekode C-bibliotek designet for å få tilgang til Personal Folder File (PFF) og Offline Folder File (OFF)-formater som brukes av Microsoft Outlook. Det gjør det mulig for utviklere å programmatisk lese, analysere og hente ut e‑post, kontakter, kalenderelementer og andre data lagret i PST-, OST-, PAB- og OFF-filer. Biblioteket støtter både 32‑bits ANSI- og 64‑bits Unicode-tegnkoding, samt komprimerte formater som 4K‑sides DEFLATE‑komprimerte OST-filer introdusert i Outlook 2013. Med sin robuste analysemotor er libpff spesielt verdifullt innen digital rettsmedisin, e‑postmigrering og datagjenopprettingsarbeidsflyter.

Biblioteket vedlikeholdes aktivt under LGPL-3.0-or-later-lisensen og er for tiden i alfa-status, noe som betyr at det er funksjonelt, men kan mangle full funksjonskompletthet eller stabilitet for produksjonsbruk. Det inkluderer verktøy for gjenoppretting av elementer og kan håndtere korrupte eller krypterte filer hvor krypteringstypen er ingen. libpff integreres også med relaterte prosjekter som libfmapi for MAPI-definisjoner og gir detaljert rettsmedisinsk dokumentasjon for å hjelpe med å analysere komplekse Outlook-filstrukturer. Utviklere kan bygge fra kildekode eller bruke forhåndskompilerte binærfiler, og prosjektet er vert på GitHub for fellesskapsbidrag og feilsporing.

Previous Next

Kom i gang med libpff

For å begynne å bruke libpff, kan du klone kildekoden fra det offisielle [libpff GitHub](https://github.com/libyal/libpff)-depotet og bygge den ved hjelp av CMake eller autotools. Ferdigkompilerte binærfiler distribueres ikke offisielt, så bygging fra kilde er den anbefalte tilnærmingen. Prosjektet inkluderer detaljerte byggeinstruksjoner og avhengigheter som libyal/libcerror og libyal/libcdata. Når den er bygget, kan du bruke de medfølgende kommandolinjeverktøyene (f.eks. `pffexport`, `pffinfo`) for å inspisere og trekke ut data fra PST/OST-filer. For programmatisk bruk, lenk mot det kompilerte biblioteket i din C/C++-applikasjon. Biblioteket er lettvektig og har minimale eksterne avhengigheter, noe som gjør det egnet for innebygde eller rettsmedisinske miljøer.

Installer libpff via kildekodebygging

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

Uttrekk e-poster og vedlegg fra PST-filer

libpff gir robust funksjonalitet for å parse PST-filer og hente ut individuelle e‑postmeldinger sammen med vedleggene deres. Utviklere kan navigere i mappestrukturen, få tilgang til meldingsegenskaper (f.eks. emne, avsender, mottakere, tidsstempler), og eksportere rå MIME‑innhold eller strukturerte data. Biblioteket støtter både ANSI‑ og Unicode‑tegnkodinger, og sikrer kompatibilitet med Outlook‑versjoner fra 1990‑tallet og opp til moderne utgivelser. Det håndterer også komprimerte OST‑filer (4K‑side DEFLATE), som er vanlige i nyere Outlook‑versjoner. Dette gjør libpff ideelt for e‑postmigrasjonsverktøy, e‑discovery‑plattformer og rettsmedisinsk analyse hvor nøyaktig uthenting av meldingskropper og vedlegg er kritisk. API‑et gir lavnivåtilgang til MAPI‑egenskaper, noe som muliggjør finjustert kontroll over datainnhenting.

Hvordan hente ut e-poster 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);

Rettmedisinsk analyse av korrupte Outlook-filer

libpff inkluderer spesialiserte evner for rettsmedisinsk analyse av skadede eller delvis korrupte Outlook-filer. Den kan analysere filer med manglende eller inkonsistente overskrifter, gjenopprette foreldreløse elementer, og rekonstruere meldingstrær selv når interne indekser er ødelagt. Biblioteket støtter filer med krypteringstype "none" og kan omgå visse strukturelle feil for å hente brukbare data. Dette er spesielt verdifullt i digitale rettsmedisinske undersøkelser hvor bevis kan befinne seg i nedbrutte PST/OST-filer. libpff gir også detaljert logging og feilrapportering, som gjør det mulig for analytikere å spore parsebeslutninger og identifisere datatapspunkter. Kombinert med sin MAPI‑egenskapsekstraksjon, fungerer libpff som et pålitelig grunnlag for å bygge rettsmedisinske verktøy som oppfyller juridiske og samsvarsstandarder.

Hvordan gjenopprette elementer fra en korrupt 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-egenskaper og metadata

libpff gjør det mulig med dyp inspeksjon av MAPI‑egenskaper som er innebygd i Outlook‑elementer. Utviklere kan hente standardegenskaper som `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, og egendefinerte egenskaper definert av applikasjoner. Biblioteket eksponerer et egenskapssett‑API som tillater iterasjon over alle egenskaper i en melding, mappe eller vedlegg. Dette er essensielt for applikasjoner som krever etterlevelsesrevisjon, metadatauttrekk eller integrasjon med MAPI‑baserte systemer. libpff støtter både navngitte og numeriske egenskapsidentifikatorer, og håndterer både 32‑bit og 64‑bit verdityper (f.eks. strenger, heltall, binære blobber). Den tette integrasjonen med libfmapi sikrer nøyaktig tolkning av MAPI‑definisjoner, noe som gjør den egnet for å bygge avanserte Outlook‑dataanalyseverktøy.

Hvordan hente ut MAPI-egenskaper fra et meldingsobjekt?

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 for lavnivå parsing, inkluderer det kommandolinjeverktøy og API-er som gjør det enkelt å eksportere Outlook-data til mye brukte formater som CSV, JSON og XML. Verktøy som `pffexport` kan konvertere PST/OST-innhold til strukturerte tekstfiler, og bevare mappestrukturen og meldingsmetadata. Utviklere kan også bruke biblioteket programmatisk for å bygge tilpassede eksportører—f.eks. kartlegge MAPI-egenskaper til JSON-objekter for innlasting i søkemotorer eller analyseplattformer. Denne eksportfunksjonaliteten er avgjørende for datamigrering, sikkerhetskopiering og integrasjon med moderne skytjenester som krever standardiserte inndataformater. libpffs fleksible design gjør at utviklere kan skreddersy eksportlogikken til spesifikke samsvars- eller arbeidsflytkrav.

Hvordan eksportere PST-innhold 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
 Norsk