RealTimeEndpoint Members

Include Protected Members
Include Inherited Members

Represents an identifiable endpoint from which you can publish or subscribe to data using data sessions or send and receive invitations using signaling sessions. Each such endpoint is uniquely identified by a URI and an endpoint ID, or a GRUU URI.

The RealTimeEndpoint type exposes the following members.

Constructors

  Name Description
Protected method RealTimeEndpoint(String, String) Constructor when URI is supplied.
Protected method RealTimeEndpoint(String, String, Boolean) Constructor when URI is supplied.
Protected method RealTimeEndpoint(String, SipTransportType, String, Boolean, Int32, String, Boolean, Boolean) Creates a new instance of SipEndpoint. This endpoint is server-based. By default, use port 5060 for TCP and 5061 for TLS. To use a port other than these, the caller should set the ServerPort property before trying to register.

Top

Properties

  Name Description
Public property ApplicationContext Gets or sets the application context.
Public property ApplicationUserAgent Gets or sets the application user agent string. This is appended to the user agent header.
Public property ConnectionManager Gets or sets the connection manager.
Public property DefaultDomain Gets the default domain of the endpoint URI.
Public propertyStatic member DefaultPeerToPeerEndpointConnectionManager Get the default connection manager for SipPeerToPeerEndpoint. This can be null if it was never used. This connection manager is used if SipPeerToPeerEndpoint is created without passing a connection manager. The application is responsible for disposing this object when it is no longer needed.
Public propertyStatic member DefaultSipEndpointConnectionManager Get the default connection manager for SipEndpoint. This can be null if it was never used. This connection manager is used if SipEndpoint is created without passing a connection manager. The application is responsible for disposing this object when it is no longer needed.
Public property DesiredSessionTimerInterval Gets or sets the desired session timer interval of the application. This is used only for the initial Invite or Response.
Public property DisableAutomaticRetryForRetryAfter Gets or sets whether the endpoint should retry requests for failed responses that contain retry-after header. By default, this is false and hence the platform will retry once more for such requests. If the applications wants to disable this automatic retry behavior, this property can be set to true. Typically, this might be needed for an application whose primary task is to perform back to back operation for two sessions where automatic retry might interfere with the ability to offer quick feedback via the back to back session so that the remote can take corrective measures.
Public property DisableReferredBySigning Obsolete. Gets or sets whether the Referred-By headers for the endpoint should be signed when configured to use MTLS.
Public property DisplayName Gets or sets the user name preferred by the application for the local user. This name will be used as the display name of the user in outgoing messages. This property indicates the display name to use in outgoing messages.
Public property EndpointUri Gets the URI of the endpoint.
Public property Gruu Gets the GRUU of the endpoint, if any. Can be null.
Public property Id Gets the ID for this endpoint. The same URI may be used on different endpoints. The ID is unique across all endpoints having the same URI.
Public property IsDialogResiliencySupported Obsolete. [Obsolete]Use ApplyRouteSetRecoverySettings method and RouteSetRecoveryMode property instead. Gets or sets value indicating if recovery attempt from failure in a dialog's signaling path is supported
Public property IsSessionTimerSupported Gets or sets the default policy used for the session timer. This value is inherited by incoming/outgoing sessions unless an incoming session requires it. The application can override the policy per session.
Public property MaximumSessionConnectDuration Gets or sets the maximum duration in minutes to wait for final response.
Public property MinimumSessionTimerInterval Gets or sets the minimum session interval. Any session-expires interval less than this value in messages will not be accepted.
Public property OwnerUri Gets the URI of the owner of the endpoint.
Public property ReliableProvisionalResponsePolicy Gets or sets the default policy for supporting 100rel extension feature. If an application supports this then the remote can ask for this when sending provisional responses which will result in PRACK message geting sent to acknowledge the response. An application should set this to set the policy globally for all sessions created. For outgoing session, ExtensionFeatureSupport.Required is not recommended since it is not meaningful and it likely to be rejected by the remote side with 420 (BadExtension) response.
Public property RouteSetRecoveryMode Gets the mode used for recovery of the session's route set.
Protected property SyncRoot Obsolete. Get the syncroot of this endpoint.
Public property Uri Gets the URI of the identity owning this endpoint.
Public property UserAgent Gets the user agent string used for messages. This includes the platform's header followed by the header supplied by the application, if any.

Top

Methods

  Name Description
Public method AddFeatureParameter(String) Adds a feature parameter. See rfc 3840.
Public method AddFeatureParameter(String, String) Adds a feature parameter. See rfc 3840.
Public method AddSipExtension Adds an extension to the list of supported extensions for Invite. If an incoming Invite message has a required header that does not exist in this list, it will be automatically rejected with 420. Once an item is added to this list, it cannot be removed. This list does not affect outgoing Invites for which the application is responsible for adding any necessary headers such as "Supported" or "Require" headers for specific SIP extensions.
Public method ApplyRouteSetRecoverySettings Applies the specified route set recovery settings to the endpoint.
Public method BeginSendMessage(MessageType, RealTimeAddress, SendMessageOptions, AsyncCallback, Object) Sends a message.
Public method BeginSendMessage(MessageType, RealTimeAddress, ContentType, [], AsyncCallback, Object) Sends a message to another endpoint.
Public method BeginSendMessage(MessageType, RealTimeAddress, ContentType, [], IEnumerable<SignalingHeader>, AsyncCallback, Object) Sends a message.
Public method BeginTerminate Terminates the endpoint and cleans up active sessions and resources. The endpoint is no longer usable.
Public method EndSendMessage Waits for the pending SendMessage operation to complete.
Public method EndTerminate Completes the asynchronous Terminate operation.
Public method Equals (inherited from Object)
Protected method Finalize (inherited from Object)
Public method GetFeatureParameterValue Gets the value of the given parameter.
Public method GetHashCode (inherited from Object)
Public method GetSupportedSipExtensions Gets the list of extensions supported by this endpoint. By default, this list is populated with extensions understood by the platform. The application can add other extensions it can support. Incoming Invite messages will be automatically rejected with 420 response if it contains a Requires header with option-tag that is not present in this list.
Public method GetTraceCorrelationID Gets the trace correlation id for this instance.
Public method GetType (inherited from Object)
Protected method MemberwiseClone (inherited from Object)
Protected method ProcessNotifyReceived Obsolete. Event handler for incoming notify request.
Protected method RegisterForPageModeMessages Register for page mode messages.
Public method RemoveFeatureParameter Removes a feature parameter matching the name if it exists.
Public method SendMessage(MessageType, RealTimeAddress, ContentType, []) Synchronously sends a message. The endpoint should be in the Connected state. This method is not recommended for a UI thread.
Public method SendMessage(MessageType, RealTimeAddress, ContentType, [], IEnumerable<SignalingHeader>) Synchronously sends a message. The session should be in connected state. This method is not recommended for a UI thread.
Public method Terminate Terminates the endpoint and cleans up active sessions and resources. The endpoint is no longer usable.
Public method ToString Returns the string representation of the object. (Overrides Object.ToString().)
Protected method UnregisterForPageModeMessages Unregister for pagemode messages

Top

Events

  Name Description
Public event MessageReceived Raised when a message is received.
Public event SessionReceived Raised when a new invitation is received.

Top

See Also

Reference

RealTimeEndpoint Class

Microsoft.Rtc.Signaling Namespace