Share via

2.2.2.7 Attachment

  • Article

The Attachment element is a required child element of the Attachments element (section 2.2.2.8) and specifies the attachment information for a single attachment item.

Command requests MUST NOT include the Attachment element.

The Attachment element is a container data type, as specified in [MS-ASDTYPE] section 2.2.

The Attachment element has the following child elements, in any order, in a Sync command response ([MS-ASCMD] section 2.2.1.21) with a Commands element ([MS-ASCMD] section 2.2.3.32), an ItemOperations command response ([MS-ASCMD] section 2.2.1.10), or a Search command response ([MS-ASCMD] section 2.2.1.16):

  • DisplayName (section 2.2.2.22.2). This element is optional.

  • FileReference (section 2.2.2.24.1). This element is required.

  • Method (section 2.2.2.31.2). This element is required.

  • EstimatedDataSize (section 2.2.2.23.1). This element is required.

  • ContentId (section 2.2.2.16.2). This element is optional.

  • ContentLocation (section 2.2.2.17.2). This element is optional.

  • IsInline (section 2.2.2.26.2). This element is optional.

  • email2:UmAttDuration ([MS-ASEMAIL] section 2.2.2.81). This element is optional.

  • email2:UmAttOrder ([MS-ASEMAIL] section 2.2.2.82). This element is optional.

The Attachment element has the following child elements, in any order, in a Sync command response with a Responses element ([MS-ASCMD] section 2.2.3.154):

  • ClientId (section 2.2.2.14). This element is required.

  • FileReference (section 2.2.2.24.1). This element is required.

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

12.0

Yes

12.1

Yes

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes

The server returns the Attachment element in a Sync command response with a Responses element only when protocol version 16.0 or 16.1 is used.