IEndpointSwitch Interface

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

Represents the switching of a web service endpoint for an organization from a primary URL to an alternate URL.

Namespace: Microsoft.Xrm.Sdk.Client
Assembly: Microsoft.Xrm.Sdk (in Microsoft.Xrm.Sdk.dll)

Syntax

public interface IEndpointSwitch

Public Interface IEndpointSwitch

	Name	Description
	AlternateEndpoint	Gets the alternate web service endpoint for accessing an organization, if one exists.
	EndpointAutoSwitchEnabled	Gets or sets whether automatic switching from the current endpoint of the web service to an alternate endpoint is enabled.
	IsPrimaryEndpoint	Gets whether the organization’s current endpoint is the primary endpoint.
	PrimaryEndpoint	Gets the primary web service endpoint for accessing an organization.

	Name	Description
	CanSwitch(Uri)	Checks if the specified endpoint URI is different from the organization’s alternate endpoint URI.
	HandleEndpointSwitch()	Fires the EndpointSwitchRequired event, then if EndpointAutoSwitchEnabled is true, switches the organization’s endpoints by calling SwitchEndpoint.
	SwitchEndpoint()	Switches the organization’s current endpoint to an alternate endpoint.

	Name	Description
	EndpointSwitched	Notification event that a failover has completed and the organization’s current endpoint has been switched to an alternate endpoint.
	EndpointSwitchRequired	Notification event that a failover has occurred and a switch from the organization’s current endpoint to an alternate endpoint is required.