2.2.3.110.3 MIMESupport (Sync)
The MIMESupport element is an optional child element of the Options element in Sync command requests that enables MIME support for email items that are sent from the server to the client.
Elements referenced in this section are defined in the AirSync namespace, except where otherwise indicated by the presence of a namespace prefix (as defined in section 2.2.4).
|
Command request/response |
Parent elements |
Child elements |
Data type |
Number allowed |
|---|---|---|---|---|
|
Sync command request (section 2.2.1.21) |
Options (section 2.2.3.125.6) |
None |
unsignedByte ([MS-ASDTYPE] section 2.8) |
0...1 (optional) |
The following table shows valid values for the element. If the MIMESupport element is not present, the default value of 0 is used.
|
Value |
Meaning |
|---|---|
|
0 |
Never send MIME data. |
|
1 |
Send MIME data for S/MIME messages only. Send regular body for all other messages. |
|
2 |
Send MIME data for all messages. This flag could be used by clients to build a more rich and complete Inbox solution. |
The client MUST send a maximum of one MIMESupport element. The result of including more than one MIMESupport element as the child element of the Options element is undefined. The server MAY return a protocol status error in response to such a command request.
The Sync request MUST include the following elements in the Options element when handling S/MIME content:
§ The MIMESupport element to tell the server to return MIME for S/MIME-only/All/None messages.
§ The airsyncbase:BodyPreference element ([MS-ASAIRS] section 2.2.2.12) with its child element, airsyncbase:Type ([MS-ASAIRS] section 2.2.2.41.4), which contains a value of 4 to inform the server that the device can read the MIME BLOB.
When handling S/MIME content in the response, the server MUST include the airsyncbase:Body element ([MS-ASAIRS] section 2.2.2.9), which is a child of the ApplicationData element (section 2.2.3.11). The airsyncbase:Body element is a complex element and MUST contain the following child elements in an S/MIME synchronization response:
§ The airsyncbase:Type element ([MS-ASAIRS] section 2.2.2.41.1) with a value of 4 to inform the device that the data is a MIME BLOB.
§ The airsyncbase:EstimatedDataSize element ([MS-ASAIRS] section 2.2.2.23.2) to specify the rough total size of the data.
§ The airsyncbase:Truncated element ([MS-ASAIRS] section 2.2.2.39.1) to indicate whether the MIME BLOB is truncated.
§ The airsyncbase:Data element ([MS-ASAIRS] section 2.2.2.20.1) that contains the full MIME BLOB.
For more details about the airsyncbase:Body element or the airsyncbase:BodyPreference element, see [MS-ASAIRS] section 2.2.2.9 or [MS-ASAIRS] section 2.2.2.12, respectively.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.
|
Protocol version |
Element support |
|---|---|
|
2.5 |
Yes |
|
12.0 |
Yes |
|
12.1 |
Yes |
|
14.0 |
Yes |
|
14.1 |
Yes |
|
16.0 |
Yes |
|
16.1 |
Yes |
This section provides details about using the airsyncbase:BodyPreference element, the airsyncbase:Body element, and the child elements of these elements when handling S/MIME content. Protocol version 2.5 does not support these elements. If protocol version 2.5 is used, the server uses the email:MIMEData, email:MIMETruncated, and email:MIMESize elements, as specified in [MS-ASEMAIL], when returning MIME data.