EWS property-related errors
Find out how to handle property-related errors in your EWS application.
Most EWS client applications will use properties, which means that you will have to handle property-related errors. You can handle these errors at runtime, or while you are developing your EWS application.
Table 1: Property-related errors and how to handle them
| Error | Caused by an attempt to… | Handle it by… |
|---|---|---|
| ErrorDataSizeLimitExceeded |
Set a property with a value that exceeds the maximum size for the property or the property does not support streaming, such as folder properties. |
Limiting the size of data you set on the property. |
| ErrorFolderPropertRequestFailed |
Get a property that could not be retrieved. |
Indicating that the property cannot be retrieved. |
| ErrorInvalidExtendedProperty |
Set an invalid combination of extended property values or results in an invalid extended property Uniform Resource Identifier (URI). |
Checking the extended property value. |
| ErrorInvalidExtendedPropertyValue |
Set an extended property value that does not match the specified type |
Updating your code to check for matching types. |
| ErrorInvalidFolderId |
Set the structure of a folder identifier to an invalid form. |
Only using identifiers returned by EWS. |
| ErrorInvalidId |
Set the structure of an identifier and/or change key to an invalid form. |
Only using identifiers returned by EWS. |
| ErrorInvalidIdEmpty |
Set an empty an identifier. |
Setting the identifier with a valid item or folder identifier. |
| ErrorInvalidIdMalformed |
Set the structure of an identifier and/or change key to an invalid form. |
Only using identifiers returned by EWS. |
| ErrorInvalidPropertyAppend |
Append a property that does not support appending. |
Updating your code so that it only attempts to append values to the recipient collection properties (To, Cc, Bcc), Attendee collection properties (Required, Optional, Resources), Body property, and the ReplyTo property. |
| ErrorInvalidPropertyDelete |
Delete a property that does not support deleting. |
Updating your code to not try to delete the property. For example, the folder and item identifiers cannot be deleted. |
| ErrorInvalidPropertyForExists |
Set an existential based search restriction on a flag-based property. |
Updating your code to not use flag-based properties in an existential based search restriction. Flag-based properties are IsDraft, IsSubmitted, IsUnmodified, IsResend, and IsFromMe. |
| ErrorInvalidPropertyForOperation |
Act on a property of an item or folder that is not supported by the operation. |
Updating your code to not access the property with the operation that caused the error. |
| ErrorInvalidPropertyRequest |
Specify a property in the request that is not supported for the item type. |
Updating your code to not try to access the property with the operation. |
| ErrorInvalidPropertySet |
Set a read-only property. |
Updating your code to not try to set the property. |
| ErrorInvalidValueForProperty |
Compare a property value in a search restriction where the comparison value does not match the property type. |
Updating your code to check for property type mismatch. |
| ErrorItemSavePropertyError |
Save an item or folder with invalid property values. |
Checking the property values and types before submitting them in a request. |
| ErrorNoFolderClassOverride |
Set the folder class on a new folder that is not the base folder type. |
Using a generic folder type to set the folder class. |
| ErrorNoPropertyTagForCustomProperties |
Reference a custom extended property by its property tag. |
Updating your code to reference the custom extended property by property set identifier and either the property name or property dispatch identifier. |
| ErrorObjectTypeChanged |
Set or update the item class on an item that doesn't match with its schema type. |
Updating your code so that item class matches the item schema type. |
| ErrorPropertyUpdate |
Update a property with an invalid property value. |
Checking the property value before submitting it in an UpdateItem request. |
| ErrorRequiredPropertyMissing |
Send a CreateAttachment request that is missing a required property. |
Updating your code to set the missing property as specified by the property path returned in the response. |
| ErrorUnsupportedMapiPropertyType |
Use extended property types of type object, object array, error or null. |
Updating your code to not use the restricted extended property types. |
| ErrorUnsupportedPathForQuery |
Use an unsupported property path in a search restriction. |
Changing the search restriction to exclude the unsupported property path. |
| ErrorUnsupportedPathForSortGroup |
Use an unsupported property path in a sorted or grouped search request. |
Changing the search restriction to exclude the unsupported property path. |
| ErrorUnsupportedTypeForConversion |
Request a property type that cannot be converted to XML for EWS to return in a response. |
Updating your code to not request the unsupported property. |
| ErrorUpdatePropertyMismatch |
Update an item or folder the change description for which doesn't match the property that is specified to be updated. |
Changing your code so that the change description matches the item or folder type that is being updated. |