2.9.2.2.1 Truncated Properties

The PidTagOfflineAddressBookTruncatedProperties ([MS-OXPROPS] section 2.821) property contains the list of property tags that have been truncated or dropped due to size limits. Clients SHOULD check the property being retrieved from the OAB record against the list of truncated properties for the record. If the property is included in the truncated property list, the value stored in the OAB file is not the same as the address book value that is available online through a corresponding address book on a name service provider interface (NSPI) server.

Properties are truncated in, or dropped from, the OAB file as follows:

• String property — A string in the OAB file is truncated to a size limit.

• Binary property — If the binary value exceeds the size limit, it is dropped from the OAB file.

• Multi-valued property (string, 32-bit integer, or binary) — If the combined size of all values exceeds the size limit, individual values are dropped from the OAB file.

• PtypObject property — The value of a PtypObject property is absent in the OAB file. The presenceBitArray, specified in section 2.9.5, is set to 0 for a PtypObject property. A PtypObject property is included in the PidTagOfflineAddressBookTruncatedProperties whenever there is a value available online through a corresponding address book on an NSPI server. This document does not include value encodings (see section 2.9.6) for properties of type PtypObject.

The following table defines the default minimum and maximum values of limit settings for string and binary data in the OAB file. The minimum limit value is the smallest value that a limit can be set to, rather than the smallest size that an actual value can be. The maximum limit value is the largest value that a size limit can be set to, and does reflect the largest size a property can be.

Limit	Type	Minimum Limit Value (in bytes)	Maximum Limit Value (in bytes)
String limit	DWORD	32	3400
Binary limit	DWORD	1024	32768
String multi-valued limit	DWORD	512	65536
32-bit integer multi-valued limit	INT32	2048	65536
Binary multi-valued limit	DWORD	2048	65536

The only properties that cannot be truncated are PidTagOfflineAddressBookTruncatedProperties, PidTagEmailAddress, and PidTagAddressBookHomeMessageDatabase. The PidTagEmailAddress and PidTagAddressBookHomeMessageDatabase properties are not limited because they are primary key values that uniquely identify an object.

The following table specifies the default attributes that SHOULD<12> be included in the PidTagOfflineAddressBookTruncatedProperties property. Each property is further specified in [MS-OXOABK] and [MS-OXPROPS].

Index Number	Property tag name	Property tag	Property type	Description
1	PidTagThumbnailPhoto ([MS-OXOABK] section 2.2.4.40)	0x8C9E0102	PtypBinary  ([MS-OXCDATA] section 2.11.1)	Contains an image of the mail user's photo in .jpg format.
2	PidTagSpokenName ([MS-OXOABK] section 2.2.4.41)	0x8CC20102	PtypBinary	Contains a recording of the mail user's name pronunciation.
3	PidTagAddressBookAuthorizedSenders ([MS-OXOABK] section 2.2.4.42)	0x8CD8000D	PtypObject ([MS-OXCDATA] section 2.11.1)	A value other than null indicates that delivery restrictions exist for this recipient. The address book does not contain the lists of senders that are allowed for this recipient; it only indicates whether or not such restrictions exist. The client can use PidTagAddressBookAuthorizedSenders, PidTagAddressBookUnauthorizedSenders ([MS-OXOABK] section 2.2.4.43), PidTagAddressBookDistributionListMemberSubmitAccepted ([MS-OXOABK] section 2.2.4.44), and PidTagAddressBookDistributionListMemberSubmitRejected ([MS-OXOABK] section 2.2.4.45) to compute a Boolean value that indicates whether a distribution list has restrictions on it.
4	PidTagAddressBookUnauthorizedSenders ([MS-OXOABK] section 2.2.4.43)	0x8CD9000D	PtypObject	A value other than null indicates that delivery restrictions exist for this recipient. The address book does not contain the lists of senders that are prohibited for this recipient; it only indicates whether or not such restrictions exist.
5	PidTagAddressBookDistributionListMemberSubmitAccepted ([MS-OXOABK] section 2.2.4.44)	0x8073000D	PtypObject	A value other than null indicates that delivery restrictions exist for this recipient. The address book does not contain the lists of the group of senders that are allowed for this recipient; it only indicates whether or not such restrictions exist.
6	PidTagAddressBookDistributionListMemberSubmitRejected ([MS-OXOABK] section 2.2.4.45)	0x8CDA000D	PtypObject	A value other than null indicates that delivery restrictions exist for this recipient. The address book does not contain the lists of the group of senders that are prohibited for this recipient; it only indicates whether or not such restrictions exist.
7	PidTagAddressBookDistributionListRejectMessagesFromDLMembers ([MS-OXPROPS] section 2.520)	0x8CDB000D	PtypObject	A value other than null indicates that delivery restrictions exist for this recipient. The address book does not contain the lists of distribution list senders that are prohibited for this recipient; it only indicates whether or not such restrictions exist.