Excludes
The Excludes element performs a bitwise mask of the specified property and a supplied value.
<Excludes>
<FieldURI/>
<Bitmask/>
</Excludes>
<Excludes>
<ExtendedFieldURI/>
<Bitmask/>
</Excludes>
<Excludes>
<IndexedFieldURI/>
<Bitmask/>
</Excludes>
ExcludesType
Attributes and elements
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child elements
| Element | Description |
|---|---|
| FieldURI |
Identifies frequently referenced properties by URI. |
| IndexedFieldURI |
Identifies individual members of a dictionary. |
| ExtendedFieldURI |
Identifies MAPI properties. |
| Bitmask |
Represents a hexadecimal or decimal mask to be used during an Excludes restriction operation. If the bitmask represents a hexadecimal number, it must be prefixed by 0x or 0X. Otherwise, it will be considered a decimal number. |
Parent elements
| Element | Description |
|---|---|
| Restriction |
Represents the restriction or query that is used to filter items or folders in FindItem/FindFolder and search folder operations. |
| Not |
Represents a search expression that negates the Boolean value of the search expression that it contains. |
| And |
Represents a search expression that allows you to perform a Boolean And operation between two or more search expressions. The result of the And operation is true if all of the search expressions contained within the And are true. |
| Or |
Represents a search expression that performs a logical OR on the search expression it contains. The Or element will return true if any of its children return true. |
Remarks
Excludes will resolve to true if an AND operation performed on the following resolves to 0:
The bitwise value for the property
The bitmask value for the property
Excludes can only be applied to a property that has an integer value. If the property type is anything other than an integer, an error code of ErrorUnsupportedPathForQuery is returned in the response.
You can perform the reverse operation by calling Not(Excludes).
The schema that describes this element is located in the EWS virtual directory of the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.
Element information
| Element | Example |
|---|---|
| Namespace |
http://schemas.microsoft.com/exchange/services/2006/types |
| Schema Name |
Types schema |
| Validation File |
Types.xsd |
| Can be Empty |
False |