2.1.3.1.1.20.1 Property: ATTACH
RFC Reference: [RFC2445] section 4.8.1.1
Number of Instances Allowed: 0+
Format: URI ([RFC2445] section 4.3.13), Binary ([RFC2445] section 4.3.1)
Brief Description: An attachment to the appointment.
Importing to Calendar objects
If the VALUE parameter (as specified in section 2.1.3.1.1.20.1.3) of this property is BINARY, then this property SHOULD<67> be parsed as a stream encoded with base64 encoding (as specified in [RFC2045] section 6.8), decoded into its raw binary form, and stored in PidTagAttachDataBinary ([MS-OXPROPS] section 2.589) of a new Attachment object with properties specified in the following table.
|
Attachment object property |
Value |
|---|---|
|
PidTagAttachDataBinary |
See the preceding paragraph |
|
PidTagAttachEncoding ([MS-OXPROPS] section 2.591) |
Set to an empty PtypBinary |
|
PidTagAttachExtension ([MS-OXPROPS] section 2.592) |
Set to the substring following the last instance of a '.' character (Unicode character U+002E) in X-FILENAME (section 2.1.3.1.1.20.1.4). If no instances of a period exist in X-FILENAME, set to a zero-length string (""). |
|
PidTagAttachFilename ([MS-OXPROPS] section 2.593) |
Set to the value of X-FILENAME (section 2.1.3.1.1.20.1.4) |
|
PidTagAttachFlags ([MS-OXPROPS] section 2.594) |
Set to 0x00000000 |
|
PidTagAttachLongFilename ([MS-OXPROPS] section 2.595) |
Set to the value of X-FILENAME (section 2.1.3.1.1.20.1.4) |
|
PidTagAttachMethod ([MS-OXPROPS] section 2.601) |
Set to 0x00000001 |
|
PidTagAttachMimeTag ([MS-OXPROPS] section 2.602) |
Imported from FMTTYPE (section 2.1.3.1.1.20.1.2) |
|
PidTagAttachmentContactPhoto ([MS-OXPROPS] section 2.597) |
Set to FALSE |
|
PidTagAttachmentFlags ([MS-OXPROPS] section 2.598) |
Set to 0x00000000 |
|
PidTagAttachmentHidden ([MS-OXPROPS] section 2.599) |
Set to FALSE |
|
PidTagAttachmentLinkId ([MS-OXPROPS] section 2.600) |
Set to 0x00000000 |
|
PidTagDisplayName |
Set to the value of X-FILENAME (section 2.1.3.1.1.20.1.4) |
|
PidTagExceptionEndTime ([MS-OXPROPS] section 2.685) |
Set to 0x0CB34557A3DD4000 |
|
PidTagExceptionStartTime ([MS-OXPROPS] section 2.687) |
Set to 0x0CB34557A3DD4000 |
|
PidTagRenderingPosition ([MS-OXPROPS] section 2.915) |
Set to 0xFFFFFFFF |
If the VALUE parameter of this property is "URI" or not defined, then this property SHOULD<68> be parsed as a URI. CID URIs (as specified in [RFC2392]) SHOULD<69> be used, for the case in which the iCalendar is embedded in a multi-part MIME e-mail to determine which attachments from the MIME will be imported into the Calendar object. Other URIs SHOULD<70> be imported into a new Attachment object with properties specified in the following table.
|
Attachment object property |
Value |
|---|---|
|
PidTagAttachDataBinary |
Set to an 8-bit text stream, containing the following text encoded in the active code page (line breaks are encoded as 0x0D followed by 0x0A):
|
|
PidTagAttachEncoding |
Set to an empty PtypBinary |
|
PidTagAttachExtension |
Set to ".url" |
|
PidTagAttachFilename |
Set to the filename parsed from the URI with a. url extension added. With respect to [RFC3986], the filename is the last segment in the higher-part of the URI. |
|
PidTagAttachFlags |
Set to 0x00000000 |
|
PidTagAttachLongFilename |
Same as PidTagAttachFilename |
|
PidTagAttachMethod |
Set to 0x00000001 |
|
PidTagAttachMimeTag |
Set to the value of FMTTYPE (section 2.1.3.1.1.20.1.2) |
|
PidTagAttachmentContactPhoto |
Set to FALSE |
|
PidTagAttachmentFlags |
Set to 0x00000000 |
|
PidTagAttachmentHidden |
Set to FALSE |
|
PidTagAttachmentLinkId |
Set to 0x00000000 |
|
PidTagDisplayName |
Same as PidTagAttachFilename |
|
PidTagExceptionEndTime |
Set to 0x0CB34557A3DD4000 |
|
PidTagExceptionStartTime |
Set to 0x0CB34557A3DD4000 |
|
PidTagRenderingPosition |
Set to 0xFFFFFFFF |
Exporting from Calendar objects
If this iCalendar is being generated as part of a MIME meeting request, all attachments in the attachments table that meet the constraints in the following table SHOULD<71> be exported as a CID URI (as specified in [RFC2392]). In this case, the value of this property MUST be a CID URI generated by treating PidTagAttachContentId ([MS-OXPROPS] section 2.587) as a CID. If PidTagAttachContentId does not exist, an [RFC2392]-compliant CID SHOULD<72> be generated and stored in PidTagAttachContentId.
If this iCalendar is being generated as part of a calendar export, all attachments in the attachments table that meet the constraints in the following table SHOULD<73> be exported as binary streams encoded with base64 encoding. The value of this property MUST be the base64 encoding of PidTagAttachDataBinary (base64 encoding is specified in [RFC2045] section 6.8).
|
Attachment Object Property |
Constraint |
|---|---|
|
PidTagAttachmentFlags |
MUST NOT have any bits set to 1 in the bit mask 0x00000007 |
|
PidTagAttachmentHidden |
MUST be unset or, if set, MUST be FALSE |
|
PidTagAttachMethod |
MUST be 0x00000001 |