This documentation is archived and is not being maintained.

GetItem Operation

Topic Last Modified: 2009-07-17

The GetItem operation gets items from the Exchange store.

The GetItem operation returns many item properties. The properties that are returned in a GetItem response vary depending on the requested shape, requested additional properties, and the type of item returned.

Starting with Microsoft Exchange Server 2007 Service Pack 1 (SP1) with Update Rollup 4 (RU4) applied, Message elements represent e-mail messages and all other items that are not strongly typed by the Exchange Web Services (EWS) schema. This behavior is applied when the Exchange2007_SP1 version header is specified. Items such as IPM.Sharing and IPM.InfoPath are returned as Message elements. Exchange 2007 SP1 with RU4 applied and later versions will not return the base Item element in responses. This change may break applications that parse the XML and expect the Item element instead of the Message element.

Also starting with Exchange 2007 SP1 with Update Rollup 4 (RU4) applied, EWS uses CPU-limited throttling in the GetItem operation to ensure that other processes on the Client Access server are not affected by an application that makes a high volume of GetItem requests in a short period of time. When the EWS process exceeds 50% CPU utilization, all requests will be forced to yield a small amount of time to limit EWS CPU utilization to 50% (this value is configurable in web.config). The delay is evenly distributed among all incoming requests.

The GetItem operation does not return attachments. It does return metadata about an attached item or file. To return an attachment, use the GetAttachment Operation.