2.2.6 View Definitions

The client and server MAY<15> store view settings as view definitions. The format of the view definitions, as well as which settings are included, is specified in sections 2.2.6.1 through 2.2.6.4.

View definitions can be created by the client to make view settings available to the server. These settings consist of column descriptions, including column header names and sizes, groupings, sort orders, and an optional restriction. The data is stored in several stream properties in an FAI message.

A message that contains view definitions MUST be an FAI message in the folder where the view is used. The message MUST have the following properties set on it, and the value of each property MUST meet the following criteria:

The message has the PidTagMessageClass property ([MS-OXCMSG] section 2.2.1.3) set and the value of the property is "IPM.Microsoft.FolderDesign.NamedView".

The message has the PidTagViewDescriptorVersion property (section 2.2.6.4) set and the value of the property is 0x00000008.

The message has the PidTagViewDescriptorName property (section 2.2.6.2) set and the value of the property is a non-empty string.

The view definitions MUST be stored as a binary stream in the PidTagViewDescriptorBinary property (section 2.2.6.1) of the message. The column headers are stored in the PidTagViewDescriptorStrings property (section 2.2.6.3) on the message as strings using the current code page of the client. Section 2.2.6.1 and section 2.2.6.3 specify the packet format of these two properties respectively.