3.2.5.4.2 Updating E-Mail Flags

For every flag update that the client sends to the server in a Sync command request ([MS-ASCMD] section 2.2.1.21), the server SHOULD update the flag on the e-mail message by using the Change element ([MS-ASCMD] section 2.2.3.24) of the Sync command. The server uses the logic specified in the following table to determine which flag action (clear, set, mark complete) to invoke when updating flag status based on the value of the Status element (section 2.2.2.74) in the Sync command request.

Action	Required Properties from Device
Flag an email	Status = 2 FlagType (section 2.2.2.35) = "Flag for follow up" tasks:StartDate (section 2.2.2.72) and tasks:UtcStartDate (section 2.2.2.87) tasks:DueDate (section 2.2.2.31) and tasks:UtcDueDate (section 2.2.2.86) or Status = 2 FlagType (section 2.2.2.35) = "Flag for follow up" tasks:DateCompleted (section 2.2.2.23) CompleteTime (section 2.2.2.19)
Flag a task	Status = 2 tasks:Subject (section 2.2.2.75.2) = user defined FlagType = "Flag for follow up" tasks:StartDate and tasks:UtcStartDate tasks:DueDate and tasks:UtcDueDate tasks:ReminderSet (section 2.2.2.64) tasks:ReminderTime (section 2.2.2.65) or Status = 2 tasks:DateCompleted CompleteTime (section 2.2.2.19)
Mark an email flag as complete	Status = 1 CompleteTime (section 2.2.2.19) tasks:DateCompleted
Mark a task flag as complete	Status = 1 CompleteTime tasks:DateCompleted
Clearing the flag on an email	Status = 0 or Flag node empty
Clearing the flag on a task	Status = 0 or Flag node empty
Update the flag metadata on an email	All updated properties
Update flag metadata on a task	All updated properties

The Sync command response includes an airsync:Status element ([MS-ASCMD] section 2.2.3.177.17) value of 6 if any of the required elements listed in the table are missing from the Sync command request.