Establishes the endpoint so that it can receive incoming calls and conference invitations.

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

Syntax

Visual Basic (Declaration) 
Public 
Function 
BeginEstablish ( _
	
userCallback 
As 
AsyncCallback, _
	
state 
As 
Object _
) 
As 
IAsyncResult
C# 
public 
IAsyncResult 
BeginEstablish(
	
AsyncCallback 
userCallback,
	
Object 
state
)
Visual C++ 
public:
IAsyncResult^ 
BeginEstablish(
	
AsyncCallback^ 
userCallback, 
	
Object^ 
state
)
JavaScript 
function 
beginEstablish(
userCallback, 
state);

Parameters

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

Return Value

An IAsyncResult that references the asynchronous operation.

Remarks

Establishing the endpoint generally means registering the endpoint against a server. When the owner is a User, the endpoint will register against the server when established. When the owner is an Application, the endpoint registers against a server most of the time. In rare and advanced cases though, it is possible not to register the local endpoint when the owner is an Application. Upon establishing the endpoint with registartion, in-band provisioning data is queried. The operation fails if in-band provisioning data fails. Note that getting the Media Relay token is a best effort operation.

Exceptions

Exception Condition
InvalidOperationException Thrown when the state of the platform or endpoint is not correct for this operation.

See Also