FindItemResponseMessage

Topic Last Modified: 2007-02-26

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

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 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.

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

See Also

Reference

FindItem Operation

Other Resources

Finding Items (Exchange Web Services)