Article
08/21/2009

Excludes

Topic Last Modified: 2007-02-19

The Excludes element performs a bitwise mask of the specified property and a supplied value.

Syntax

<Excludes>
   <FieldURI/>
   <Bitmask/>
</Excludes>

<Excludes>
   <IndexedFieldURI/>
   <Bitmask/>
</Excludes>

<Excludes>
   <ExtendedFieldURI/>
   <Bitmask/>
</Excludes>

Type

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

Namespace	https://schemas.microsoft.com/exchange/services/2006/types
Schema Name	Types schema
Validation File	Types.xsd
Can be Empty	False

Partager via