primitives.h

Go to the documentation of this file.

 
 
 
#ifndef PSTSDK_UTIL_PRIMITIVES_H
#define PSTSDK_UTIL_PRIMITIVES_H
 
#include <boost/config.hpp>
#include <boost/cstdint.hpp>
#include <cstring>
 
//
// Global compiler hacks
//
 
#ifdef BOOST_NO_RVALUE_REFERENCES
#ifndef SUPPRESS_CPLUSPLUS0X_MESSAGES
#pragma message("C++0x rvalue references not supported; consider updating your compiler")
#endif
#endif
 
#ifdef BOOST_NO_STATIC_ASSERT
#include <boost/static_assert.hpp>
#define static_assert(x,y) BOOST_STATIC_ASSERT(x)
#endif
 
#ifndef PSTSDK_VALIDATION_LEVEL_NONE
#define PSTSDK_VALIDATION_LEVEL_WEAK
#endif
 
#ifdef PSTSDK_VALIDATION_LEVEL_FULL
// full validation also implies weak validation
#define PSTSDK_VALIDATION_LEVEL_WEAK
#endif
 
// Many of the low-level data structures in pstsdk rely on being laid out
// in the fashion preferred by Visual C++.  For example, these structures
// need to align ulonglong to the nearest 8 bytes.  Under GCC, we can force
// this layout behavior on Mac and Linux systems by appending an
// appropriate attribute declaration to the structure.  We're also tried
// '#pragma ms_struct on', but it fails on at least some Linux systems.
#ifdef __GNUC__
#define PSTSDK_MS_STRUCT __attribute__((ms_struct))
#else
#define PSTSDK_MS_STRUCT
#endif
 
namespace pstsdk
{
 
typedef boost::uint32_t uint;
typedef boost::uint32_t ulong;
typedef boost::int32_t slong;
typedef boost::uint64_t ulonglong;
typedef boost::int64_t slonglong;
typedef boost::uint8_t byte;
typedef boost::uint16_t ushort;
static_assert(sizeof(byte) == 1, "pstsdk::byte unexpected size");
static_assert(sizeof(ushort) == 2, "pstsdk::ushort unexpected size");
static_assert(sizeof(uint) == 4, "pstsdk::uint unexpected size");
static_assert(sizeof(ulonglong) == 8, "pstsdk::ulonglong unexpected size");
 
typedef ulong node_id;
typedef ulonglong block_id;
typedef block_id page_id;
 
typedef ulong heap_id;
typedef ulong heapnode_id;
 
typedef ushort prop_id;
 
typedef ulong row_id;
struct alias_tag { };
 
//
// node id
//
 
enum nid_type
{
    nid_type_none = 0x00,
    nid_type_internal = 0x01,
    nid_type_folder = 0x02,
    nid_type_search_folder = 0x03,
    nid_type_message = 0x04,
    nid_type_attachment = 0x05,
    nid_type_search_update_queue = 0x06,
    nid_type_search_criteria_object = 0x07,
    nid_type_associated_message = 0x08,
    nid_type_storage = 0x09,
    nid_type_contents_table_index = 0x0A,
    nid_type_receive_folder_table = 0x0B,
    nid_type_outgoing_queue_table = 0x0C,
    nid_type_hierarchy_table = 0x0D,
    nid_type_contents_table = 0x0E,
    nid_type_associated_contents_table = 0x0F,
    nid_type_search_contents_table = 0x10,
    nid_type_attachment_table = 0x11,
    nid_type_recipient_table = 0x12,
    nid_type_search_table_index = 0x13,
    nid_type_contents_smp = 0x14,
    nid_type_associated_contents_smp = 0x15,
    nid_type_change_history_table = 0x16,
    nid_type_tombstone_table = 0x17,
    nid_type_tombstone_date_table = 0x18,
    nid_type_lrep_dups_table = 0x19,
    nid_type_folder_path_tombstone_table = 0x1A,
    nid_type_ltp = 0x1F,
    nid_type_max = 0x20
};
 
const ulong nid_type_mask = 0x1FL;
 
#define make_nid(nid_type,nid_index) (((nid_type)&nid_type_mask)|((nid_index) << 5))
 
#define make_prv_pub_nid(nid_index) (make_nid(nid_type_folder, nid_index_prv_pub_base + (nid_index)))
 
enum predefined_nid
{
    nid_message_store = make_nid(nid_type_internal, 0x1),   
    nid_name_id_map = make_nid(nid_type_internal, 0x3),     
    nid_normal_folder_template = make_nid(nid_type_folder, 0x6),
    nid_search_folder_template = make_nid(nid_type_search_folder, 0x7),
    nid_root_folder = make_nid(nid_type_folder, 0x9),       
    nid_search_management_queue = make_nid(nid_type_internal, 0xF),
    nid_search_activity_list = make_nid(nid_type_internal, 0x10),
    nid_search_domain_alternative = make_nid(nid_type_internal, 0x12),
    nid_search_domain_object = make_nid(nid_type_internal, 0x13),
    nid_search_gatherer_queue = make_nid(nid_type_internal, 0x14),
    nid_search_gatherer_descriptor = make_nid(nid_type_internal, 0x15),
    nid_table_rebuild_queue = make_nid(nid_type_internal, 0x17),
    nid_junk_mail_pihsl = make_nid(nid_type_internal, 0x18),
    nid_search_gatherer_folder_queue = make_nid(nid_type_internal, 0x19),
    nid_tc_sub_props = make_nid(nid_type_internal, 0x27),
    nid_index_template = 0x30,
    nid_hierarchy_table_template = make_nid(nid_type_hierarchy_table, nid_index_template),
    nid_contents_table_template = make_nid(nid_type_contents_table, nid_index_template),
    nid_associated_contents_table_template = make_nid(nid_type_associated_contents_table, nid_index_template),
    nid_search_contents_table_template = make_nid(nid_type_search_contents_table, nid_index_template),
    nid_smp_template = make_nid(nid_type_contents_smp, nid_index_template),
    nid_tombstone_table_template = make_nid(nid_type_tombstone_table, nid_index_template),
    nid_lrep_dups_table_template = make_nid(nid_type_lrep_dups_table, nid_index_template),
    nid_receive_folders = make_nid(nid_type_receive_folder_table, 0x31),
    nid_outgoing_queue = make_nid(nid_type_outgoing_queue_table, 0x32),
    nid_attachment_table = make_nid(nid_type_attachment_table, 0x33),
    nid_recipient_table = make_nid(nid_type_recipient_table, 0x34),
    nid_change_history_table = make_nid(nid_type_change_history_table, 0x35),
    nid_tombstone_table = make_nid(nid_type_tombstone_table, 0x36),
    nid_tombstone_date_table = make_nid(nid_type_tombstone_date_table, 0x37),
    nid_all_message_search_folder = make_nid(nid_type_search_folder, 0x39), 
    nid_all_message_search_contents = make_nid(nid_type_search_contents_table, 0x39),
    nid_lrep_gmp = make_nid(nid_type_internal, 0x40),
    nid_lrep_folders_smp = make_nid(nid_type_internal, 0x41),
    nid_lrep_folders_table = make_nid(nid_type_internal, 0x42),
    nid_folder_path_tombstone_table = make_nid(nid_type_internal, 0x43),
    nid_hst_hmp = make_nid(nid_type_internal, 0x60),
    nid_index_prv_pub_base = 0x100,
    nid_pub_root_folder = make_prv_pub_nid(0),
    nid_prv_root_folder = make_prv_pub_nid(5),
    nid_criterr_notification = make_nid(nid_type_internal, 0x3FD),
    nid_object_notification = make_nid(nid_type_internal, 0x3FE),
    nid_newemail_notification = make_nid(nid_type_internal, 0x3FF),
    nid_extended_notification = make_nid(nid_type_internal, 0x400),
    nid_indexing_notification = make_nid(nid_type_internal, 0x401)
};
 
inline nid_type get_nid_type(node_id id)
    { return (nid_type)(id & nid_type_mask); }
 
inline ulong get_nid_index(node_id id)
    { return id >> 5; }
 
//
// heap id
//
 
inline ulong get_heap_page(heap_id id)
    { return (id >> 16); } 
 
inline ulong get_heap_index(heap_id id)
    { return (((id >> 5) - 1) & 0x7FF); }
 
inline heap_id make_heap_id(ulong page, ulong index)
    { return (heap_id)((page << 16) | ((index + 1) << 5)); }
 
//
// heapnode id
//
 
inline bool is_heap_id(heapnode_id id)
    { return (get_nid_type(id) == nid_type_none); }
 
inline bool is_subnode_id(heapnode_id id)
    { return (get_nid_type(id) != nid_type_none); }
 
//
// properties
//
 
enum prop_type
{
    prop_type_unspecified = 0,
    prop_type_null = 1,
    prop_type_short = 2,
    prop_type_mv_short = 4098,
    prop_type_long = 3,
    prop_type_mv_long = 4099,
    prop_type_float = 4,
    prop_type_mv_float = 4100,
    prop_type_double = 5,
    prop_type_mv_double = 4101,
    prop_type_currency = 6,
    prop_type_mv_currency = 4102,
    prop_type_apptime = 7,          
    prop_type_mv_apptime = 4103,
    prop_type_error = 10,
    prop_type_boolean = 11,
    prop_type_object = 13,
    prop_type_longlong = 20,
    prop_type_mv_longlong = 4116,
    prop_type_string = 30,
    prop_type_mv_string = 4126,
    prop_type_wstring = 31,
    prop_type_mv_wstring = 4127,
    prop_type_systime = 64,         
    prop_type_mv_systime = 4160,
    prop_type_guid = 72,
    prop_type_mv_guid = 4168,
    prop_type_binary = 258,
    prop_type_mv_binary = 4354,
};
 
//
// mapi recipient type
//
 
enum recipient_type
{
    mapi_to = 1,
    mapi_cc = 2,
    mapi_bcc = 3
};
 
// 
// message specific values
//
 
const byte message_subject_prefix_lead_byte = 0x01;
 
//
// Win32 GUID
//
 
struct guid
{
    ulong data1;
    ushort data2;
    ushort data3;
    byte data4[8];
} PSTSDK_MS_STRUCT;
 
inline bool guid_eq(const guid &l, const guid &r) {
    auto small_parts = l.data1 == r.data1 && l.data2 == r.data2 && l.data3 == r.data3;
    if (!small_parts) return small_parts;
    return small_parts && !std::memcmp(&l.data4, &r.data4, 8);
}
 
static_assert(sizeof(guid) == 16, "guid incorrect size");
 
const guid ps_none = { 0, 0, 0, { 0, 0, 0, 0, 0, 0, 0, 0 } };
 
const guid ps_mapi = { 0x20328, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid ps_public_strings = { 0x20329, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid ps_appointment = {0x62002, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid ps_task = {0x62003, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid ps_common = {0x62008, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid ps_address = {0x62004, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid ps_meeting = {0x6ED8DA90, 0x450B, 0x101B, { 0x98, 0xDA, 0x00, 0xAA, 0x00, 0x3F, 0x13, 0x05 } };
 
const guid ps_internet_headers = {0x20386, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid ps_sharing = {0x62040, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid ps_log = {0x6200A, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid ps_postrss = {0x62041, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid ps_note = {0x6200E, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid ps_calendarassistant = {0x11000E07, 0xB51B, 0x40D6, { 0xAF, 0x21, 0xCA, 0xA8, 0x5E, 0xDA, 0xB1, 0xD0 } };
 
const guid ps_remote = {0x62014, 0, 0, { 0xc0, 0, 0, 0, 0, 0, 0, 0x46 } };
 
const guid provider_uid_wrapped_entry_id = {0xD3AD91C0, 0x9D51, 0x11CF, { 0xA4, 0xA9, 0x00, 0xAA, 0x00, 0x47, 0xFA, 0xA4 } };
 
const guid provider_uid_recipient_oneoff = {0xA41F2B81, 0xA3BE, 0x1910, { 0x9D, 0x6E, 0x00, 0xDD, 0x01, 0x0F, 0x54, 0x02 } };
 
} // end pstsdk namespace
#endif