Provided by: libpff-dev_20180714-3.1build1_amd64 
NAME
libpff.h — Library to access the Personal Folder File (OST, PAB and PST) format
SYNOPSIS
#include <libpff.h>
Support functions
const char *
libpff_get_version(void);
int
libpff_get_access_flags_read(void);
int
libpff_get_codepage(int *codepage, libpff_error_t **error);
int
libpff_set_codepage(int codepage, libpff_error_t **error);
int
libpff_check_file_signature(const char *filename, libpff_error_t **error);
Available when compiled with wide character string support:
int
libpff_check_file_signature_wide(const wchar_t *filename, libpff_error_t **error);
Available when compiled with libbfio support:
int
libpff_check_file_signature_file_io_handle(libbfio_handle_t *file_io_handle, libpff_error_t **error);
Notify functions
void
libpff_notify_set_verbose(int verbose);
int
libpff_notify_set_stream(FILE *stream, libpff_error_t **error);
int
libpff_notify_stream_open(const char *filename, libpff_error_t **error);
int
libpff_notify_stream_close(libpff_error_t **error);
Error functions
void
libpff_error_free(libpff_error_t **error);
int
libpff_error_fprint(libpff_error_t *error, FILE *stream);
int
libpff_error_sprint(libpff_error_t *error, char *string, size_t size);
int
libpff_error_backtrace_fprint(libpff_error_t *error, FILE *stream);
int
libpff_error_backtrace_sprint(libpff_error_t *error, char *string, size_t size);
File functions
int
libpff_file_initialize(libpff_file_t **file, libpff_error_t **error);
int
libpff_file_free(libpff_file_t **file, libpff_error_t **error);
int
libpff_file_signal_abort(libpff_file_t *file, libpff_error_t **error);
int
libpff_file_open(libpff_file_t *file, const char *filename, int access_flags, libpff_error_t **error);
int
libpff_file_close(libpff_file_t *file, libpff_error_t **error);
int
libpff_file_is_corrupted(libpff_file_t *file, libpff_error_t **error);
int
libpff_file_recover_items(libpff_file_t *file, uint8_t recovery_flags, libpff_error_t **error);
int
libpff_file_get_size(libpff_file_t *file, size64_t *size, libpff_error_t **error);
int
libpff_file_get_content_type(libpff_file_t *file, uint8_t *content_type, libpff_error_t **error);
int
libpff_file_get_type(libpff_file_t *file, uint8_t *type, libpff_error_t **error);
int
libpff_file_get_encryption_type(libpff_file_t *file, uint8_t *encryption_type, libpff_error_t **error);
int
libpff_file_get_ascii_codepage(libpff_file_t *file, int *ascii_codepage, libpff_error_t **error);
int
libpff_file_set_ascii_codepage(libpff_file_t *file, int ascii_codepage, libpff_error_t **error);
int
libpff_file_get_number_of_unallocated_blocks(libpff_file_t *file, int unallocated_block_type,
int *number_of_unallocated_blocks, libpff_error_t **error);
int
libpff_file_get_unallocated_block(libpff_file_t *file, int unallocated_block_type,
int unallocated_block_index, off64_t *offset, size64_t *size, libpff_error_t **error);
int
libpff_file_get_root_item(libpff_file_t *file, libpff_item_t **root_item, libpff_error_t **error);
int
libpff_file_get_message_store(libpff_file_t *file, libpff_item_t **message_store,
libpff_error_t **error);
int
libpff_file_get_name_to_id_map(libpff_file_t *file, libpff_item_t **name_to_id_map,
libpff_error_t **error);
int
libpff_file_get_root_folder(libpff_file_t *file, libpff_item_t **root_folder, libpff_error_t **error);
int
libpff_file_get_item_by_identifier(libpff_file_t *file, uint32_t item_identifier, libpff_item_t **item,
libpff_error_t **error);
int
libpff_file_get_number_of_orphan_items(libpff_file_t *file, int *number_of_orphan_items,
libpff_error_t **error);
int
libpff_file_get_orphan_item_by_index(libpff_file_t *file, int orphan_item_index,
libpff_item_t **orphan_item, libpff_error_t **error);
int
libpff_file_get_number_of_recovered_items(libpff_file_t *file, int *number_of_recovered_items,
libpff_error_t **error);
int
libpff_file_get_recovered_item_by_index(libpff_file_t *file, int recovered_item_index,
libpff_item_t **recovered_item, libpff_error_t **error);
Available when compiled with wide character string support:
int
libpff_file_open_wide(libpff_file_t *file, const wchar_t *filename, int access_flags,
libpff_error_t **error);
Available when compiled with libbfio support:
int
libpff_file_open_file_io_handle(libpff_file_t *file, libbfio_handle_t *file_io_handle, int access_flags,
libpff_error_t **error);
Item functions
int
libpff_item_clone(libpff_item_t **destination_item, libpff_item_t *source_item, libpff_error_t **error);
int
libpff_item_free(libpff_item_t **item, libpff_error_t **error);
int
libpff_item_get_identifier(libpff_item_t *item, uint32_t *identifier, libpff_error_t **error);
int
libpff_item_get_number_of_record_sets(libpff_item_t *item, int *number_of_record_sets,
libpff_error_t **error);
int
libpff_item_get_record_set_by_index(libpff_item_t *item, int record_set_index,
libpff_record_set_t **record_set, libpff_error_t **error);
int
libpff_item_get_number_of_entries(libpff_item_t *item, uint32_t *number_of_entries,
libpff_error_t **error);
int
libpff_item_get_type(libpff_item_t *item, uint8_t *item_type, libpff_error_t **error);
int
libpff_item_get_number_of_sub_items(libpff_item_t *item, int *number_of_sub_items,
libpff_error_t **error);
int
libpff_item_get_sub_item(libpff_item_t *item, int sub_item_index, libpff_item_t **sub_item,
libpff_error_t **error);
int
libpff_item_get_sub_item_by_identifier(libpff_item_t *item, uint32_t sub_item_identifier,
libpff_item_t **sub_item, libpff_error_t **error);
Name to ID map entry functions
int
libpff_name_to_id_map_entry_get_type(libpff_name_to_id_map_entry_t *name_to_id_map_entry,
uint8_t *entry_type, libpff_error_t **error);
int
libpff_name_to_id_map_entry_get_number(libpff_name_to_id_map_entry_t *name_to_id_map_entry,
uint32_t *number, libpff_error_t **error);
int
libpff_name_to_id_map_entry_get_utf8_string_size(libpff_name_to_id_map_entry_t *name_to_id_map_entry,
size_t *utf8_string_size, libpff_error_t **error);
int
libpff_name_to_id_map_entry_get_utf8_string(libpff_name_to_id_map_entry_t *name_to_id_map_entry,
uint8_t *utf8_string, size_t utf8_string_size, libpff_error_t **error);
int
libpff_name_to_id_map_entry_get_utf16_string_size(libpff_name_to_id_map_entry_t *name_to_id_map_entry,
size_t *utf16_string_size, libpff_error_t **error);
int
libpff_name_to_id_map_entry_get_utf16_string(libpff_name_to_id_map_entry_t *name_to_id_map_entry,
uint16_t *utf16_string, size_t utf16_string_size, libpff_error_t **error);
int
libpff_name_to_id_map_entry_get_guid(libpff_name_to_id_map_entry_t *name_to_id_map_entry, uint8_t *guid,
size_t size, libpff_error_t **error);
Record set functions
int
libpff_record_set_free(libpff_record_set_t **record_set, libpff_error_t **error);
int
libpff_record_set_get_number_of_entries(libpff_record_set_t *record_set, int *number_of_entries,
libpff_error_t **error);
int
libpff_record_set_get_entry_by_index(libpff_record_set_t *record_set, int record_entry_index,
libpff_record_entry_t **record_entry, libpff_error_t **error);
int
libpff_record_set_get_entry_by_type(libpff_record_set_t *record_set, uint32_t entry_type,
uint32_t value_type, libpff_record_entry_t **record_entry, uint8_t flags, libpff_error_t **error);
int
libpff_record_set_get_entry_by_utf8_name(libpff_record_set_t *record_set, const uint8_t *utf8_string,
size_t utf8_string_length, uint32_t value_type, libpff_record_entry_t **record_entry, uint8_t flags,
libpff_error_t **error);
int
libpff_record_set_get_entry_by_utf16_name(libpff_record_set_t *record_set, const uint16_t *utf16_string,
size_t utf16_string_length, uint32_t value_type, libpff_record_entry_t **record_entry, uint8_t flags,
libpff_error_t **error);
Record entry functions
int
libpff_record_entry_free(libpff_record_entry_t **record_entry, libpff_error_t **error);
int
libpff_record_entry_get_entry_type(libpff_record_entry_t *record_entry, uint32_t *entry_type,
libpff_error_t **error);
int
libpff_record_entry_get_value_type(libpff_record_entry_t *record_entry, uint32_t *value_type,
libpff_error_t **error);
int
libpff_record_entry_get_name_to_id_map_entry(libpff_record_entry_t *record_entry,
libpff_name_to_id_map_entry_t **name_to_id_map_entry, libpff_error_t **error);
int
libpff_record_entry_get_data_size(libpff_record_entry_t *record_entry, size_t *data_size,
libpff_error_t **error);
int
libpff_record_entry_get_data(libpff_record_entry_t *record_entry, uint8_t *data, size_t data_size,
libpff_error_t **error);
int
libpff_record_entry_get_data_as_boolean(libpff_record_entry_t *record_entry, uint8_t *value_boolean,
libpff_error_t **error);
int
libpff_record_entry_get_data_as_16bit_integer(libpff_record_entry_t *record_entry, uint16_t *value_16bit,
libpff_error_t **error);
int
libpff_record_entry_get_data_as_32bit_integer(libpff_record_entry_t *record_entry, uint32_t *value_32bit,
libpff_error_t **error);
int
libpff_record_entry_get_data_as_64bit_integer(libpff_record_entry_t *record_entry, uint64_t *value_64bit,
libpff_error_t **error);
int
libpff_record_entry_get_data_as_filetime(libpff_record_entry_t *record_entry, uint64_t *filetime,
libpff_error_t **error);
int
libpff_record_entry_get_data_as_floatingtime(libpff_record_entry_t *record_entry, uint64_t *floatingtime,
libpff_error_t **error);
int
libpff_record_entry_get_data_as_size(libpff_record_entry_t *record_entry, size64_t *value_size,
libpff_error_t **error);
int
libpff_record_entry_get_data_as_floating_point(libpff_record_entry_t *record_entry,
double *value_floating_point, libpff_error_t **error);
int
libpff_record_entry_get_data_as_utf8_string_size(libpff_record_entry_t *record_entry,
size_t *utf8_string_size, libpff_error_t **error);
int
libpff_record_entry_get_data_as_utf8_string(libpff_record_entry_t *record_entry, uint8_t *utf8_string,
size_t utf8_string_size, libpff_error_t **error);
int
libpff_record_entry_get_data_as_utf16_string_size(libpff_record_entry_t *record_entry,
size_t *utf16_string_size, libpff_error_t **error);
int
libpff_record_entry_get_data_as_utf16_string(libpff_record_entry_t *record_entry, uint16_t *utf16_string,
size_t utf16_string_size, libpff_error_t **error);
int
libpff_record_entry_get_data_as_guid(libpff_record_entry_t *record_entry, uint8_t *guid_data,
size_t guid_data_size, libpff_error_t **error);
int
libpff_record_entry_get_multi_value(libpff_record_entry_t *record_entry,
libpff_multi_value_t **multi_value, libpff_error_t **error);
ssize_t
libpff_record_entry_read_buffer(libpff_record_entry_t *record_entry, uint8_t *buffer, size_t buffer_size,
libpff_error_t **error);
off64_t
libpff_record_entry_seek_offset(libpff_record_entry_t *record_entry, off64_t offset, int whence,
libpff_error_t **error);
Multi value functions
int
libpff_multi_value_free(libpff_multi_value_t **multi_value, libpff_error_t **error);
int
libpff_multi_value_get_number_of_values(libpff_multi_value_t *multi_value, int *number_of_values,
libpff_error_t **error);
int
libpff_multi_value_get_value(libpff_multi_value_t *multi_value, int value_index, uint32_t *value_type,
uint8_t **value_data, size_t *value_data_size, libpff_error_t **error);
int
libpff_multi_value_get_value_32bit(libpff_multi_value_t *multi_value, int value_index,
uint32_t *value_32bit, libpff_error_t **error);
int
libpff_multi_value_get_value_64bit(libpff_multi_value_t *multi_value, int value_index,
uint64_t *value_64bit, libpff_error_t **error);
int
libpff_multi_value_get_value_filetime(libpff_multi_value_t *multi_value, int value_index,
uint64_t *value_64bit, libpff_error_t **error);
int
libpff_multi_value_get_value_utf8_string_size(libpff_multi_value_t *multi_value, int value_index,
size_t *utf8_string_size, libpff_error_t **error);
int
libpff_multi_value_get_value_utf8_string(libpff_multi_value_t *multi_value, int value_index,
uint8_t *utf8_string, size_t utf8_string_size, libpff_error_t **error);
int
libpff_multi_value_get_value_utf16_string_size(libpff_multi_value_t *multi_value, int value_index,
size_t *utf16_string_size, libpff_error_t **error);
int
libpff_multi_value_get_value_utf16_string(libpff_multi_value_t *multi_value, int value_index,
uint16_t *utf16_string, size_t utf16_string_size, libpff_error_t **error);
int
libpff_multi_value_get_value_binary_data_size(libpff_multi_value_t *multi_value, int value_index,
size_t *size, libpff_error_t **error);
int
libpff_multi_value_get_value_binary_data(libpff_multi_value_t *multi_value, int value_index,
uint8_t *binary_data, size_t size, libpff_error_t **error);
int
libpff_multi_value_get_value_guid(libpff_multi_value_t *multi_value, int value_index, uint8_t *guid,
size_t size, libpff_error_t **error);
Folder item functions
int
libpff_folder_get_type(libpff_item_t *folder, uint8_t *type, libpff_error_t **error);
int
libpff_folder_get_utf8_name_size(libpff_item_t *folder, size_t *utf8_string_size,
libpff_error_t **error);
int
libpff_folder_get_utf8_name(libpff_item_t *folder, uint8_t *utf8_string, size_t utf8_string_size,
libpff_error_t **error);
int
libpff_folder_get_utf16_name_size(libpff_item_t *folder, size_t *utf16_string_size,
libpff_error_t **error);
int
libpff_folder_get_utf16_name(libpff_item_t *folder, uint16_t *utf16_string, size_t utf16_string_size,
libpff_error_t **error);
int
libpff_folder_get_number_of_sub_folders(libpff_item_t *folder, int *number_of_sub_folders,
libpff_error_t **error);
int
libpff_folder_get_sub_folder(libpff_item_t *folder, int sub_folder_index, libpff_item_t **sub_folder,
libpff_error_t **error);
int
libpff_folder_get_sub_folder_by_utf8_name(libpff_item_t *folder, uint8_t *utf8_sub_folder_name,
size_t utf8_sub_folder_name_size, libpff_item_t **sub_folder, libpff_error_t **error);
int
libpff_folder_get_sub_folder_by_utf16_name(libpff_item_t *folder, uint16_t *utf16_sub_folder_name,
size_t utf16_sub_folder_name_size, libpff_item_t **sub_folder, libpff_error_t **error);
int
libpff_folder_get_sub_folders(libpff_item_t *folder, libpff_item_t **sub_folders,
libpff_error_t **error);
int
libpff_folder_get_number_of_sub_messages(libpff_item_t *folder, int *number_of_sub_messages,
libpff_error_t **error);
int
libpff_folder_get_sub_message(libpff_item_t *folder, int sub_message_index, libpff_item_t **sub_message,
libpff_error_t **error);
int
libpff_folder_get_sub_message_by_utf8_name(libpff_item_t *folder, uint8_t *utf8_sub_message_name,
size_t utf8_sub_message_name_size, libpff_item_t **sub_message, libpff_error_t **error);
int
libpff_folder_get_sub_message_by_utf16_name(libpff_item_t *folder, uint16_t *utf16_sub_message_name,
size_t utf16_sub_message_name_size, libpff_item_t **sub_message, libpff_error_t **error);
int
libpff_folder_get_sub_messages(libpff_item_t *folder, libpff_item_t **sub_messages,
libpff_error_t **error);
int
libpff_folder_get_number_of_sub_associated_contents(libpff_item_t *folder,
int *number_of_sub_associated_contents, libpff_error_t **error);
int
libpff_folder_get_sub_associated_content(libpff_item_t *folder, int sub_associated_content_index,
libpff_item_t **sub_associated_content, libpff_error_t **error);
int
libpff_folder_get_sub_associated_contents(libpff_item_t *folder, libpff_item_t **sub_associated_contents,
libpff_error_t **error);
int
libpff_folder_get_unknowns(libpff_item_t *folder, libpff_item_t **unknowns, libpff_error_t **error);
Message item functions
int
libpff_message_get_entry_value_utf8_string_size(libpff_item_t *message, uint32_t entry_type,
size_t *utf8_string_size, libpff_error_t **error);
int
libpff_message_get_entry_value_utf8_string(libpff_item_t *message, uint32_t entry_type,
uint8_t *utf8_string, size_t utf8_string_size, libpff_error_t **error);
int
libpff_message_get_entry_value_utf16_string_size(libpff_item_t *message, uint32_t entry_type,
size_t *utf16_string_size, libpff_error_t **error);
int
libpff_message_get_entry_value_utf16_string(libpff_item_t *message, uint32_t entry_type,
uint16_t *utf16_string, size_t utf16_string_size, libpff_error_t **error);
int
libpff_message_get_client_submit_time(libpff_item_t *message, uint64_t *filetime,
libpff_error_t **error);
int
libpff_message_get_delivery_time(libpff_item_t *message, uint64_t *filetime, libpff_error_t **error);
int
libpff_message_get_creation_time(libpff_item_t *message, uint64_t *filetime, libpff_error_t **error);
int
libpff_message_get_modification_time(libpff_item_t *message, uint64_t *filetime, libpff_error_t **error);
int
libpff_message_get_number_of_attachments(libpff_item_t *message, int *number_of_attachments,
libpff_error_t **error);
int
libpff_message_get_attachment(libpff_item_t *message, int attachment_index, libpff_item_t **attachment,
libpff_error_t **error);
int
libpff_message_get_attachments(libpff_item_t *message, libpff_item_t **attachments,
libpff_error_t **error);
int
libpff_message_get_recipients(libpff_item_t *message, libpff_item_t **recipients,
libpff_error_t **error);
int
libpff_message_get_plain_text_body_size(libpff_item_t *message, size_t *size, libpff_error_t **error);
int
libpff_message_get_plain_text_body(libpff_item_t *message, uint8_t *message_body, size_t size,
libpff_error_t **error);
int
libpff_message_get_rtf_body_size(libpff_item_t *message, size_t *size, libpff_error_t **error);
int
libpff_message_get_rtf_body(libpff_item_t *message, uint8_t *message_body, size_t size,
libpff_error_t **error);
int
libpff_message_get_html_body_size(libpff_item_t *message, size_t *size, libpff_error_t **error);
int
libpff_message_get_html_body(libpff_item_t *message, uint8_t *message_body, size_t size,
libpff_error_t **error);
Attachment item functions
int
libpff_attachment_get_type(libpff_item_t *attachment, int *attachment_type, libpff_error_t **error);
int
libpff_attachment_get_data_size(libpff_item_t *attachment, size64_t *size, libpff_error_t **error);
ssize_t
libpff_attachment_data_read_buffer(libpff_item_t *attachment, uint8_t *buffer, size_t buffer_size,
libpff_error_t **error);
off64_t
libpff_attachment_data_seek_offset(libpff_item_t *attachment, off64_t offset, int whence,
libpff_error_t **error);
int
libpff_attachment_get_item(libpff_item_t *attachment, libpff_item_t **attached_item,
libpff_error_t **error);
Available when compiled with libbfio support:
int
libpff_attachment_get_data_file_io_handle(libpff_item_t *attachment, libbfio_handle_t **file_io_handle,
libpff_error_t **error);
DESCRIPTION
The libpff_get_version() function is used to retrieve the library version.
RETURN VALUES
Most of the functions return NULL or -1 on error, dependent on the return type. For the actual return
values see "libpff.h".
ENVIRONMENT
None
FILES
None
NOTES
libpff can be compiled with wide character support (wchar_t).
To compile libpff with wide character support use: ./configure --enable-wide-character-type=yes
or define: _UNICODE
or UNICODE
during compilation.
LIBPFF_WIDE_CHARACTER_TYPE
in libpff/features.h can be used to determine if libpff was compiled with wide character support.
BUGS
Please report bugs of any kind on the project issue tracker: https://github.com/libyal/libpff/issues
AUTHOR
These man pages are generated from "libpff.h".
COPYRIGHT
Copyright (C) 2008-2018, Joachim Metz <joachim.metz@gmail.com>.
This is free software; see the source for copying conditions. There is NO warranty; not even for
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
SEE ALSO
the libpff.h include file
libpff January 15, 2017 libpff(3)