2.2.2.24.1 FileReference (Attachment)

  • Article

The FileReference element is a required child element of the Attachment element (section 2.2.2.7) that specifies the location of an item on the server to retrieve.

The FileReference element is a string data type, as specified in [MS-ASDTYPE] section 2.7.

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

In protocol version 16.0 and 16.1, the server will return the FileReference element along with the ClientId element (section 2.2.2.14) as child elements of the Attachment element in response to a Sync command request ([MS-ASCMD] section 2.2.1.21) that adds an attachment either to a calendar item or to a draft email item. The client MUST record the value of the FileReference element that is returned. This value will be used to specify the attachment in a future Sync command request if the client deletes the attachment.