2.2.4.3.6 folderContent Element

The folderContent element contains the content of a folder: its properties, messages, and subfolders.

The propList element, as specified in section 2.2.4.3.20, contains the properties of the Folder object, which are possibly affected by property filters, as specified in section 3.2.5.10.

The following table lists the restrictions that exist on the contained propList element.

Property name

Restrictions

Comments

PidTagFolderId (section 2.2.1.2.2)

Conditional

Fixed position

MUST be present if and only if the first marker in the folder element is not the StartTopFld marker, as specified in section 2.2.4.1.4.

PidTagDisplayName ([MS-OXCFOLD] section 2.2.2.2.2.5)

Conditional

Fixed position

MUST be present if and only if the first marker in the folder element is not the StartTopFld marker

PidTagComment ([MS-OXCFOLD] section 2.2.2.2.2.2)

Conditional

Fixed position

MUST be present if and only if the first marker in the folder element is not the StartTopFld marker

MetaTagEcWarning (section 2.2.4.1.5.2)

Conditional

Fixed position

MAY<22> be output by the server if the client set the Move flag of the CopyFlags field and the user does not have permissions to delete the source folder.

< other properties >

No restrictions

None.

For more details about the impact of property and subobject filters that are specified when configuring an operation on the content of this element, see section 3.2.5.10.

The MetaTagNewFXFolder meta-property (section 2.2.4.1.5.3) MUST be output instead of message elements when outputting a public folder whose contents do not exist on the server because the content is ghosted. If there is a valid replica (1) of the public folder on the server and the folder content has not replicated to the server yet, the folder content is not included in the FastTransfer stream as part of the folderContent element. The server SHOULD NOT include any data following the MetaTagNewFXFolder meta-property in the buffer returned by the RopFastTransferSourceGetBuffer ROP (section 2.2.3.1.1.5), although additional data can be included in the FastTransfer stream. Any data included after this property in the buffer returned by the RopFastTransferSourceGetBuffer ROP is ignored by the client, which results in a parsing failure when the client attempts to parse the next buffer.

Under conditions specified in section 3.2.5.10, the PidTagContainerHierarchy property ([MS-OXPROPS] section 2.646) included in a subFolder element MUST be preceded by a MetaTagFXDelProp meta-property (section 2.2.4.1.5.1).