Edit

Share via


MultiplayerService.SetTransferHandleAsync Method

Definition

Extends the access rights for the caller from the origin session to the target session. For example, in a title with a lobby session and a game session, the title could put a transfer handle linking the lobby to the game inside the lobby session. Users invited to the lobby can use the handle to join the game session as well. The transfer handle is deleted once the target session is deleted.

public Windows.Foundation.IAsyncOperation<string> SetTransferHandleAsync (Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference targetSessionReference, Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference originSessionReference);
abstract member SetTransferHandleAsync : Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference * Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference -> Windows.Foundation.IAsyncOperation<string>
override this.SetTransferHandleAsync : Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference * Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference -> Windows.Foundation.IAsyncOperation<string>
Public Function SetTransferHandleAsync (targetSessionReference As MultiplayerSessionReference, originSessionReference As MultiplayerSessionReference) As IAsyncOperation(Of String)

Parameters

targetSessionReference
MultiplayerSessionReference

Target multiplayer_session_reference for the session you want to extend the access rights to.

originSessionReference
MultiplayerSessionReference

Origin multiplayer_session_reference for the session that grants access to the target session.

Returns

Windows.Foundation.IAsyncOperation<String>

Returns an IAsyncOperation<TResult> object that represents the state of the asynchronous operation. Completion of the asynchronous operation is signaled by using a handler that is passed to the IAsyncOperation<TResult>.Completed property. When the asynchronous operation is complete, the result of the operation can be retrieved by using the IAsyncOperation<TResult>.GetResults method.

The result is a string that contains the transfer handle ID.

Implements

Microsoft.Xbox.Services.Multiplayer.__IMultiplayerServicePublicNonVirtuals.SetTransferHandleAsync(Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference,Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference)

Applies to