Article
08/21/2009

FindItemResponseMessage

Topic Last Modified: 2007-02-26

The FindItemResponseMessage element contains the status and result of a single FindItem request.

Schema Hierarchy

FindItemResponse
ResponseMessages
FindItemResponseMessage

Syntax

<FindItemResponseMessage ResponseClass="">
   <MessageText/>
   <ResponseCode/>
   <DescriptiveLinkKey/>
   <MessageXml/>
   <RootFolder/>
</FindItemResponseMessage>

Type

FindItemResponseMessageType

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
ResponseClass	Describes the status of a FindItem response. The following values are valid for this attribute: Success Warning Error

ResponseClass

Describes the status of a FindItem response. The following values are valid for this attribute:

Success
Warning
Error

ResponseClass Attribute Values

Value	Description
Success	Describes a request that is fulfilled.
Warning	Describes a request that was not processed. A warning may be returned if an error occurred while processing an item in the request was processing and subsequent items could not be processed. The following are examples of sources of warnings: The Exchange store goes offline during the batch. Active Directory goes offline. Mailboxes are moved. MDB goes offline. Password is expired. Quota was exceeded.
Error	Describes a request that cannot be fulfilled. The following are examples of sources of errors: Invalid attributes or elements Attributes or elements out of range Unknown tag Attribute or element not valid in the context Unauthorized access attempted by any client Server-side failure in response to a valid client-side call Information about the error can be found in the ResponseCode and MessageText elements.

Success

Describes a request that is fulfilled.

Warning

Describes a request that was not processed. A warning may be returned if an error occurred while processing an item in the request was processing and subsequent items could not be processed. The following are examples of sources of warnings:

The Exchange store goes offline during the batch.
Active Directory goes offline.
Mailboxes are moved.
MDB goes offline.
Password is expired.
Quota was exceeded.

Error

Describes a request that cannot be fulfilled. The following are examples of sources of errors:

Invalid attributes or elements
Attributes or elements out of range
Unknown tag
Attribute or element not valid in the context
Unauthorized access attempted by any client
Server-side failure in response to a valid client-side call

Information about the error can be found in the ResponseCode and MessageText elements.

Child Elements

Element	Description
MessageText	Provides a text description of the status of the response.
ResponseCode	Provides an error code that identifies the specific error that the request encountered.
DescriptiveLinkKey	Currently unused and is reserved for future use. It contains a value of 0.
MessageXml	Provides additional error response information.
RootFolder (FindItemResponseMessage)	Contains the results from a search of a single root folder during a FindItem operation.

Parent Elements

Element	Description
ResponseMessages	Contains the response messages for an Exchange Web Services request.

Remarks

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/messages
Schema name	Messages schema
Validation file	Messages.xsd
Can be empty	False