3.1.4.2 Mail App Accesses Configuration Data

When a mail add-in accesses its configuration data, the client performs the following steps:

  1. Looks up the identifier for the mail add-in in the manifest, as specified in [MS-OWEMXML].

  2. Generates a value for the PidTagMessageClass property ([MS-OXCMSG] section 2.2.1.3) by using the procedure specified in section 2.2.4.

  3. Opens the configuration data message with the value generated in step 2 in the PidTagMessageClass property by using the procedure specified in [MS-OXOCFG] section 3.1.4.1.

  4. Reads the configuration data from the PidTagRoamingDictionary property ([MS-OXOCFG] section 2.2.2.2) on the configuration data message opened in step 3 by using the procedure specified in [MS-OXOCFG] section 3.1.4.1.1.

  5. Returns the configuration data to the mail add-in.

If a mail add-in changes any of its configuration data, the client updates the JSON object, as specified in section 2.2.4, with the new information and updates the dictionary on the configuration data message as specified in [MS-OXOCFG] section 3.1.4.2.1. The client saves the changes to the configuration data message as specified in [MS-OXOCFG] section 3.1.4.2.

Show: