SipSubscription.BeginSubscribe Method

Creates an subscribe request body and puts the workItem in queue to invoke Subscribe.

Namespace:  Microsoft.Rtc.Signaling
Assembly:  Microsoft.Rtc.Collaboration (in Microsoft.Rtc.Collaboration.dll)

Syntax

'Declaration
Public Function BeginSubscribe ( _
    userCallback As AsyncCallback, _
    state As Object _
) As IAsyncResult
'Usage
Dim instance As SipSubscription
Dim userCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult

returnValue = instance.BeginSubscribe(userCallback, _
    state)
public IAsyncResult BeginSubscribe(
    AsyncCallback userCallback,
    Object state
)

Parameters

  • userCallback
    Type: System.AsyncCallback
    The method to be called when the asynchronous operation is completed.
  • state
    Type: System.Object
    A user-provided object that distinguishes this particular asynchronous operation from other asynchronous operations.

Return Value

Type: System.IAsyncResult
An IAsyncResult that references the asynchronous operation.

Exceptions

Exception Condition
InvalidOperationException

Thrown when the Subscribe/BeginSubscribe operation to this SipSubscription had already been called.

InvalidOperationException

Thrown when the endpoint is terminating.

InvalidOperationException

Thrown if event package is "vnd-microsoft-roaming-self" and RealTimeEndpoint already have a subscription for this event.

Remarks

Multiple subscription for the event "vnd-microsoft-roaming-self" are not allowed from same endpoint, so establishing another subscription session for this event will cause InvalidOperationException.

See Also

Reference

SipSubscription Class

SipSubscription Members

Microsoft.Rtc.Signaling Namespace