Request versioning in the EWS Managed API 2.0

EWS Managed API

Learn how to specify the version for EWS requests.

Last modified: January 09, 2014

Applies to: EWS Managed API | Exchange Server 2007 Service Pack 1 (SP1) | Exchange Server 2010

Note: This content applies to the EWS Managed API 2.0 and earlier versions. For the latest information about the EWS Managed API, see Web services in Exchange.

Versioning provides a way for an Exchange Web Services (EWS) client to indicate the contract that the server should use to validate and process the client request. This enables the client to access the EWS Managed API objects, methods, and properties that are available in the specified version.

By using the EWS Managed API, the client can set the version when instantiating the ExchangeService object. All requests that use a specific ExchangeService object are validated against the EWS schema of the version of Exchange that was specified when the ExchangeService object was instantiated. The EWS Managed API will throw an exception if an EWS client tries to access an object, method, or property that is not supported by the specified version.

For information about how to set the Exchange Server version by using the EWS Managed API, see Versioning EWS requests by using the EWS Managed API 2.0.