2.2.3.41.1 DeepTraversal (Find)
The DeepTraversal element is an optional child element of the Options element in Find command requests that indicates that the client wants the server to search all subfolders for the folder that is specified in the query.
All elements referenced in this section are defined in the Find namespace.
|
Command request/response |
Parent elements |
Child elements |
Data type |
Number allowed |
|---|---|---|---|---|
|
Find command request (section 2.2.1.2) |
Options (section 2.2.3.125.1) |
None |
None |
0...1 (optional) |
The DeepTraversal element is not used in the Options element of the GALSearchCriterion element in the Find command request.
The DeepTraversal element is an empty tag element, meaning it has no value or data type. It is distinguished only by the presence or absence of the <DeepTraversal/> tag. If the DeepTraversal element and the CollectionId element are not present, all folders returned in FolderSync and their subfolders will be searched. If the DeepTraversal element and the CollectionId element are present, the folder specified by the CollectionId and all its subfolders are searched.
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 |
|
|
12.1 |
|
|
14.0 |
|
|
14.1 |
|
|
16.0 |
|
|
16.1 |
Yes |