1. Produkte
  2.   Email
  3.   C++
  4.   libpff

libpff

 
 

Open-Source-C-Bibliothek für Outlook-Dateiformate

Lesen, Analysieren und Extrahieren von Daten aus PST-, OST-, PAB- und OFF-Dateien über eine kostenlose Open-Source-C-API.

Was ist libpff?

libpff ist eine leistungsstarke Open-Source-C-Bibliothek, die entwickelt wurde, um auf die Formate Personal Folder File (PFF) und Offline Folder File (OFF) zuzugreifen, die von Microsoft Outlook verwendet werden. Sie ermöglicht Entwicklern, programmgesteuert E‑Mails, Kontakte, Kalendereinträge und andere in PST-, OST-, PAB- und OFF-Dateien gespeicherte Daten zu lesen, zu analysieren und zu extrahieren. Die Bibliothek unterstützt sowohl 32‑Bit‑ANSI‑ als auch 64‑Bit‑Unicode‑Zeichenkodierungen sowie komprimierte Formate wie die in Outlook 2013 eingeführten 4‑K‑Seiten‑DEFLATE‑komprimierten OST‑Dateien. Mit ihrer robusten Parsing‑Engine ist libpff besonders wertvoll in den Bereichen digitale Forensik, E‑Mail‑Migration und Datenwiederherstellung.

Die Bibliothek wird aktiv unter der LGPL-3.0-or-later-Lizenz gepflegt und currently处于 alpha status, was bedeutet, dass sie funktional ist, aber möglicherweise nicht die volle Funktionsvollständigkeit oder Stabilität für den Produktionseinsatz bietet. Sie enthält Werkzeuge zur Wiederherstellung von Elementen und kann beschädigte oder verschlüsselte Dateien verarbeiten, bei denen der Verschlüsselungstyp keiner ist. libpff integriert sich auch in verwandte Projekte wie libfmapi für MAPI-Definitionen und stellt detaillierte forensische Dokumentation bereit, um komplexe Outlook-Dateistrukturen zu analysieren. Entwickler können aus dem Quellcode bauen oder vorgefertigte Binärdateien verwenden, und das Projekt wird auf GitHub für Community-Beiträge und Fehlerverfolgung gehostet.

Previous Next

Erste Schritte mit libpff

Um libpff zu verwenden, können Sie den Quellcode aus dem offiziellen [libpff GitHub](https://github.com/libyal/libpff) Repository klonen und ihn mit CMake oder autotools bauen. Vorgefertigte Binärdateien werden nicht offiziell verteilt, daher ist das Erstellen aus dem Quellcode der empfohlene Ansatz. Das Projekt enthält detaillierte Build‑Anleitungen und Abhängigkeiten wie libyal/libcerror und libyal/libcdata. Nach dem Build können Sie die bereitgestellten Befehlszeilentools (z. B. `pffexport`, `pffinfo`) verwenden, um PST/OST‑Dateien zu untersuchen und Daten zu extrahieren. Für die programmgesteuerte Nutzung binden Sie die kompilierte Bibliothek in Ihre C/C++‑Anwendung ein. Die Bibliothek ist leichtgewichtig und hat minimale externe Abhängigkeiten, was sie für eingebettete oder forensische Umgebungen geeignet macht.

libpff über Quellcode-Build installieren

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

E-Mails und Anhänge aus PST-Dateien extrahieren

libpff bietet robuste Funktionalität zum Parsen von PST-Dateien und zum Extrahieren einzelner E-Mail-Nachrichten zusammen mit deren Anhängen. Entwickler können die Ordnerhierarchie durchlaufen, auf Nachrichteneigenschaften (z. B. Betreff, Absender, Empfänger, Zeitstempel) zugreifen und rohe MIME-Inhalte oder strukturierte Daten exportieren. Die Bibliothek unterstützt sowohl ANSI- als auch Unicode-Zeichenkodierungen und gewährleistet Kompatibilität mit Outlook-Versionen von den 1990er‑Jahren bis zu modernen Releases. Sie verarbeitet außerdem komprimierte OST-Dateien (4‑K‑Seiten‑DEFLATE), die in neueren Outlook-Versionen üblich sind. Das macht libpff ideal für E‑Mail-Migrationswerkzeuge, E‑Discovery‑Plattformen und forensische Analysen, bei denen die genaue Extraktion von Nachrichtenkörpern und Anhängen entscheidend ist. Die API stellt einen Low‑Level‑Zugriff auf MAPI‑Eigenschaften bereit, der eine feinkörnige Kontrolle über die Datenabfrage ermöglicht.

Wie extrahiere ich E-Mails aus einer PST-Datei über die 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 beschädigter Outlook-Dateien

libpff enthält spezialisierte Fähigkeiten für die forensische Analyse beschädigter oder teilweise korrupter Outlook-Dateien. Es kann Dateien mit fehlenden oder inkonsistenten Headern analysieren, verwaiste Elemente wiederherstellen und Nachrichtenbäume rekonstruieren, selbst wenn interne Indizes beschädigt sind. Die Bibliothek unterstützt Dateien mit dem Verschlüsselungstyp "none" und kann bestimmte strukturelle Fehler umgehen, um nutzbare Daten zu extrahieren. Dies ist besonders wertvoll in digitalen Forensik-Untersuchungen, bei denen Beweise in degradierten PST/OST-Dateien liegen können. libpff bietet zudem detailliertes Logging und Fehlermeldungen, die Analysten ermöglichen, Parsing-Entscheidungen nachzuverfolgen und Datenverlustpunkte zu identifizieren. In Kombination mit seiner MAPI-Property-Extraktion dient libpff als zuverlässige Grundlage für den Aufbau forensischer Werkzeuge, die rechtlichen und Compliance-Standards entsprechen.

Wie man Elemente aus einer beschädigten PST-Datei wiederherstellt?

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-Eigenschaften und Metadaten parsen

libpff ermöglicht eine tiefgehende Inspektion von MAPI‑Eigenschaften, die in Outlook‑Elementen eingebettet sind. Entwickler können Standard‑Eigenschaften wie `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME` und von Anwendungen definierte benutzerdefinierte Eigenschaften abrufen. Die Bibliothek stellt ein Property‑Set‑API bereit, das die Iteration über alle Eigenschaften einer Nachricht, eines Ordners oder eines Anhangs erlaubt. Dies ist essenziell für Anwendungen, die Compliance‑Audits, Metadaten‑Extraktion oder die Integration mit MAPI‑basierten Systemen benötigen. libpff unterstützt sowohl benannte als auch numerische Eigenschaftskennungen und verarbeitet sowohl 32‑Bit‑ als auch 64‑Bit‑Wertetypen (z. B. Zeichenketten, Ganzzahlen, Binärblobs). Die enge Integration mit libfmapi gewährleistet eine genaue Interpretation der MAPI‑Definitionen und macht es geeignet, fortgeschrittene Outlook‑Datenanalyse‑Tools zu erstellen.

Wie man MAPI-Eigenschaften aus einem Nachrichtenelement extrahiert?

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

Daten in Standardformate exportieren (CSV, JSON, XML)

Während libpff in erster Linie eine C-Bibliothek für Low-Level-Parsing ist, enthält sie Befehlszeilen‑Utilities und APIs, die das Exportieren von Outlook‑Daten in weit verbreitete Formate wie CSV, JSON und XML erleichtern. Werkzeuge wie `pffexport` können PST/OST‑Inhalte in strukturierte Textdateien konvertieren und dabei die Ordnerhierarchie sowie Nachrichten‑Metadaten erhalten. Entwickler können die Bibliothek auch programmgesteuert nutzen, um benutzerdefinierte Exporter zu erstellen – z. B. MAPI‑Eigenschaften in JSON‑Objekte zuzuordnen, um sie in Suchmaschinen oder Analyseplattformen zu importieren. Diese Export‑Funktion ist entscheidend für Datenmigration, Sicherung und die Integration mit modernen Cloud‑Diensten, die standardisierte Eingabeformate benötigen. Das flexible Design von libpff ermöglicht es Entwicklern, die Exportlogik an spezifische Compliance‑ oder Workflow‑Anforderungen anzupassen.

Wie man PST-Inhalte über die CLI nach JSON exportiert?

# 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
 Deutsch