Bewerken

EWS property-related errors

  • Artikel

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.

See also