2.2.4 Mail App Configuration Data

Mail app–specific configuration data is stored as dictionary configuration data in the user's inbox, as specified in [MS-OXOCFG] section 2.2.5.1. The value of the PidTagMessageClass property ([MS-OXCMSG] section 2.2.1.3) on the Message object that stores the dictionary configuration data is set to "IPM.Configuration.ClientExtension.<ID>", where "<ID>" is replaced with a value derived from the value of the Id child element of the OfficeApp element that represents the mail add-in in the mail add-in manifest, as specified in [MS-OWEMXML]. The value is derived by using the following procedure:

  1. Replace any uppercase alphabetic characters in the value of the Id element with their lowercase equivalent. For example, 'A' becomes 'a'.

  2. Remove any braces ('{' or '}') from the value.

  3. Remove any dashes ('-') from the value.

  4. If present, remove the "urn:uuid" prefix from the value.

The client-specific configuration data is stored in JavaScript Object Notation (JSON) in a name-value pair in an e element in the PidTagRoamingDictionary property ([MS-OXOCFG] section 2.2.2.2), as specified in [MS-OXOCFG] section 2.2.5.1. The name of the name-value pair is ExtensionSettings, and the value is the JSON object that represents the mail app's settings. Note that the name-value pairs within the JSON object are specific to the mail add-in.

Show: