ChatRoomSession.BeginJoin Method

Definition

Overloads

BeginJoin(ChatRoomSummary, AsyncCallback, Object)

Joins the chat room indicated by the given ChatRoomSummary.

BeginJoin(String, AsyncCallback, Object)

Joins the chat room with the given name.

BeginJoin(Uri, AsyncCallback, Object)

Joins the chat room indicated by the given URI.

BeginJoin(ChatRoomSummary, AsyncCallback, Object)

Joins the chat room indicated by the given ChatRoomSummary.

public:
 IAsyncResult ^ BeginJoin(Microsoft::Rtc::Collaboration::PersistentChat::ChatRoomSummary ^ chatRoomSummary, AsyncCallback ^ userCallback, System::Object ^ state);
public IAsyncResult BeginJoin (Microsoft.Rtc.Collaboration.PersistentChat.ChatRoomSummary chatRoomSummary, AsyncCallback userCallback, object state);
member this.BeginJoin : Microsoft.Rtc.Collaboration.PersistentChat.ChatRoomSummary * AsyncCallback * obj -> IAsyncResult

Parameters

chatRoomSummary
ChatRoomSummary

The chat room summary.

userCallback
AsyncCallback

The callback method to be invoked when this asynchronous operation completes.

state
Object

An object to be passed back to the callback.

Returns

An IAsyncResult that references this operation.

Exceptions

chatRoomSummary is null.

The chat room is already joined.

The PersistentChatEndpoint encountered an error communicating with the chat server.

Remarks

To join a chat room, a user must be an authorized member. Only one active ChatRoomSession may exist for any given chat room per endpoint. This request will be processed asynchronously. See EndJoin(IAsyncResult) to complete this asynchronous operation.

Applies to

BeginJoin(String, AsyncCallback, Object)

Joins the chat room with the given name.

public:
 IAsyncResult ^ BeginJoin(System::String ^ chatRoomName, AsyncCallback ^ userCallback, System::Object ^ state);
public IAsyncResult BeginJoin (string chatRoomName, AsyncCallback userCallback, object state);
member this.BeginJoin : string * AsyncCallback * obj -> IAsyncResult
Public Function BeginJoin (chatRoomName As String, userCallback As AsyncCallback, state As Object) As IAsyncResult

Parameters

chatRoomName
String

Name of the chat room to join.

userCallback
AsyncCallback

The callback method to be invoked when this asynchronous operation completes.

state
Object

An object to be passed back to the callback.

Returns

An IAsyncResult object that references this operation.

Exceptions

chatRoomName is null or empty.

The chat room is already joined.

The PersistentChatEndpoint encountered an error communicating with the persistent chat server.

Remarks

To join a chat room, a user must be an authorized member. Only one active ChatRoomSession may exist for any given chat room per endpoint. This request will be processed asynchronously. Call EndJoin(IAsyncResult) to complete this asynchronous operation.

Applies to

BeginJoin(Uri, AsyncCallback, Object)

Joins the chat room indicated by the given URI.

public:
 IAsyncResult ^ BeginJoin(Uri ^ chatRoomUri, AsyncCallback ^ userCallback, System::Object ^ state);
public IAsyncResult BeginJoin (Uri chatRoomUri, AsyncCallback userCallback, object state);
member this.BeginJoin : Uri * AsyncCallback * obj -> IAsyncResult
Public Function BeginJoin (chatRoomUri As Uri, userCallback As AsyncCallback, state As Object) As IAsyncResult

Parameters

chatRoomUri
Uri

The chat room URI.

userCallback
AsyncCallback

The callback method to be invoked when this asynchronous operation completes.

state
Object

An object to be passed back to the callback.

Returns

An IAsyncResult that references this operation.

Exceptions

chatRoomUri is null.

chatRoomUri is not a valid chat room URI.

The chat room is already joined.

The PersistentChatEndpoint encountered an error communicating with the chat server.

Remarks

To join a chat room, a user must be an authorized member. Only one active ChatRoomSession may exist for any given chat room per endpoint. This request will be processed asynchronously. Call EndJoin(IAsyncResult) to complete this asynchronous operation.

Applies to