2.2.4 UI Configuration

  • Article

A client application can display an enhanced user interface (UI) for Message objects with the message classes specified in section 2.2.2.1 for some users and not for others. In addition, the client can show UI configuration information related to a user's telephony experience for some users and not for others. The server SHOULD store settings for these options on a per-user basis, and the client MUST consult these settings before it attempts to implement the aforementioned UI segmentation.

This could be useful in a scenario in which a certain group of users are not provisioned by their administrator to receive the message classes specified in section 2.2.2.1 and/or are not provisioned to have telephony access to their messages.

If the client or server sets or uses this configuration information, it MUST treat this information as a dictionary stream by using the Configuration Information Protocol, as specified in [MS-OXOCFG].

The dictionary stream object MUST be stored in the Inbox special folder, as specified in [MS-OXOSFLD] section 2.2.7.

The dictionary stream MUST have the PidTagMessageClass property ([MS-OXCMSG] section 2.2.1.3) set on it. The value of this property MUST be IPM.Configuration.UMOLK.UserOptions.

The dictionary stream SHOULD include the following outlookFlags parameter, which is used to indicate whether the client displays telephony configuration UI and special UI information for message classes. If the outlookFlags parameter does not appear in the dictionary stream or the dictionary stream does not exist, the default value 0x00000000 SHOULD be assumed.

  • Name (string): "outlookFlags"

  • Value (32-bit integer): The least significant bit MUST correspond to whether the client displays special UI information for message classes that are specified in section 2.2.2.1. The second-least significant bit MUST correspond to whether the client displays telephony configuration UI. The four possible values are listed in the following table; the value 0x00000000 is the default.

    Value

    Meaning

    0x00000000

    Display neither the special UI information for message classes nor the telephony configuration UI.

    0x00000001

    Display only the special UI information for message classes.

    0x00000002

    Display only the telephony configuration UI.

    0x00000003

    Display both the special UI information for message classes and the telephony configuration UI.