SipSubscription Members

Include Protected Members
Include Inherited Members

Provides low-level subscription and notification. Users of this class need to pass the ISubscriptionProcessor interface to interact with the subscription. It automatically refreshes the subscription, 15 minutes before the expiry. Users of SipSubscription can also refresh the subscription themselves.

The SipSubscription type exposes the following members.

Constructors

  Name Description
Public method SipSubscription(RealTimeEndpoint, RealTimeAddress, String, ISipSubscriptionProcessor) Creates the SipSubscription object and initializes the values.
Public method SipSubscription(RealTimeEndpoint, RealTimeAddress, String, ISipSubscriptionProcessor, Boolean) Creates the SipSubscription object and initializes the values.
Public method SipSubscription(RealTimeEndpoint, RealTimeAddress, String, ISipSubscriptionProcessor, Boolean, String) Creates the SipSubscription object and initializes the values.

Top

Properties

  Name Description
Public property CurrentState Gets the current signaling state of the subscription.
Public property EventPackage Gets the name of the event package, for which this subscription is created.
Public property IsActive Gets true if current state is subscribed or refreshing.
Public property IsQueryOnly Gets true or false. When IsQueryOnly is set to true, Expires 0 header would be automatically added on the underlying subscription. The default value is false.
Public property SubscriberEndpoint Gets the endpoint of the subscriber who creates this subscription.
Public property Target Gets the target to be used in the "To" header in the Subscribe request.
Public property TimeRemainingToRefresh Gets the time span remaining to expire this subscription.

Top

Methods

  Name Description
Public method BeginRefresh Creates a transaction async result to refresh an existing subscription and puts the workitem in queue. Refresh is allowed only if the current subscription state is valid. Multiple simultaneous refreshes are allowed, but not recommended for the application.
Public method BeginSendUpdateMessage Send an update message on existing subscription dialog, this is useful where server allows the chnage in the semantics of existing subscription dialog especially used for LS batch subscriptions.
Public method BeginSubscribe Creates an subscribe request body and puts the workItem in queue to invoke Subscribe.
Public method BeginTerminate If a subscription exists, then terminate the subscription; else completed as no operation.
Public method EndRefresh Ends the pending refresh operation.
Public method EndSendUpdateMessage Ends the pending Subscription Update operation.
Public method EndSubscribe Ends the pending asynchronous subscribe operation.
Public method EndTerminate Ends the pending terminate operation.
Public method Equals (inherited from Object)
Protected method Finalize (inherited from Object)
Public method GetHashCode (inherited from Object)
Public method GetTraceCorrelationID Gets the trace correlation id for this instance.
Public method GetType (inherited from Object)
Protected method MemberwiseClone (inherited from Object)
Public method Refresh Synchronous version of BeginRefresh and EndRefresh.
Public method Subscribe Synchronous version of BeginSubscribe and EndSubscribe.
Public method Terminate Synchronous version of BeginTerminate and EndTerminate.
Public method ToString Returns the string representation for the SipSubscription object, which basically contains endpointId, event, and the current subscription state. (Overrides Object.ToString().)

Top

See Also

Reference

SipSubscription Class

Microsoft.Rtc.Signaling Namespace