RetrieveExchangeAppointmentsRequest Class

Article
11/28/2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Retrieves the appointments for the current user for a specific date range from the exchange web service.

For the Web API use the RetrieveExchangeAppointments Function.

Web API support for this message was added with December 2016 update for Microsoft Dynamics 365 (online) and December 2016 Service Pack for Microsoft Dynamics 365 (on-premises) .

Namespace: Microsoft.Crm.Sdk.Messages
Assembly: Microsoft.Crm.Sdk.Proxy (in Microsoft.Crm.Sdk.Proxy.dll)

Inheritance Hierarchy

System.Object
Microsoft.Xrm.Sdk.OrganizationRequest
Microsoft.Crm.Sdk.Messages.RetrieveExchangeAppointmentsRequest

Syntax

[DataContractAttribute(Namespace = "https://schemas.microsoft.com/crm/2011/Contracts")]
public sealed class RetrieveExchangeAppointmentsRequest : OrganizationRequest

<DataContractAttribute(Namespace := "https://schemas.microsoft.com/crm/2011/Contracts")>
Public NotInheritable Class RetrieveExchangeAppointmentsRequest
    Inherits OrganizationRequest

Constructors

	Name	Description
	RetrieveExchangeAppointmentsRequest()	Initializes a new instance of the RetrieveExchangeAppointmentsRequest class.

Properties

	Name	Description
	EndDate	Gets or sets the end date of the range in UTC.
	ExtensionData	Gets or sets the structure that contains extra data. Optional.(Inherited from OrganizationRequest.)
	Item[String]	Gets or sets the indexer for the Parameters collection.(Inherited from OrganizationRequest.)
	Parameters	Gets or sets the collection of parameters for the request. Required, but is supplied by derived classes.(Inherited from OrganizationRequest.)
	RequestId	Gets or sets the ID of an asynchronous operation (system job). Optional. (Inherited from OrganizationRequest.)
	RequestName	Gets or sets the name of the request. Required, but is supplied by derived classes.(Inherited from OrganizationRequest.)
	StartDate	Gets or sets the start date of the range in UTC.

Methods

	Name	Description
	Equals(Object)	(Inherited from Object.)
	GetHashCode()	(Inherited from Object.)
	GetType()	(Inherited from Object.)
	ToString()	(Inherited from Object.)

Remarks

Use of this message requires that the proper Mailbox and Email Server are set up for the user. If these are not property configured, this message can return the following errors;

Error	Possible Cause
The remote server returned an error: (401) Unauthorized.	Email credentials are incorrect.
The remote name could not be resolved: '<hostname>'	Invalid Exchange Web Services endpoint
The remote server returned an error: (403) Forbidden.	Invalid SSL (HTTPS) settings
Could not determine exchange server URL..	Auto discovery error.

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.