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. |