Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

2.2.3.55 EmptyFolderContents

The EmptyFolderContents element is an optional child element of the ItemOperations element in ItemOperations command requests and an optional child element of the Response element in ItemOperations responses. In both contexts, the EmptyFolderContents element identifies the body of the request or response as containing the operation that deletes the contents of a folder.

Elements referenced in this section are defined in the ItemOperations namespace, except where otherwise indicated by the presence of a namespace prefix (as defined in section 2.2.1).

Command request/response

Parent elements

Child elements

Data type

Number allowed

ItemOperations command request (section 2.2.2.9)

ItemOperations (section 2.2.3.85)

airsync:CollectionId (section 2.2.3.30.2)

Options (section 2.2.3.115.2)

container ([MS-ASDTYPE] section 2.2)

0...N (optional)

ItemOperations command response

Response (section 2.2.3.140.3)

airsync:CollectionId (section 2.2.3.30.2)

Status (section 2.2.3.162.7)

container

0...N (optional)

The EmptyFolderContents element enables the client to empty a folder of all its items. The element supports a single child element of the Options element, the DeleteSubFolders element (section 2.2.3.44), which determines whether subfolders contained in the folder are deleted. If the DeleteSubFolders option is not included in the request, the subfolders of the specified airsync:CollectionId are not deleted.

Specifically, clients use EmptyFolderContents to empty the Deleted Items folder. The client can clear out all items in the Deleted Items folder when the user runs out of storage quota (indicated by the return of an HTTP 507 status code from the server).

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.4, 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

X

12.1

X

14.0

X

14.1

X

Show:
© 2015 Microsoft