Skip to main content

​
XblMultiplayerSetTransferHandleAsync

The access rights the caller has to the origin session are extended to the target session.

​
Syntax

​
Parameters

xblContext   _In_
Type: XblContextHandle XBOX live context for the local user. targetSessionReference   _In_
Type: XblMultiplayerSessionReference Target XblMultiplayerSessionReference for the session you want to extend the access rights for. originSessionReference   _In_
Type: XblMultiplayerSessionReference Origin XblMultiplayerSessionReference for the session that grants access to the target session. async   _In_
Type: XAsyncBlock* The AsyncBlock for this operation.

​
Return value

Type: HRESULT HRESULT return code for this API operation.

​
Remarks

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.

​
Requirements

Header: multiplayer_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

​
See also

multiplayer_c
Last modified on August 20, 2026

Related topics

XblMultiplayerSetTransferHandleResultMultiplayer tasksXblMultiplayerSetActivityAsyncXblMultiplayerActivitySetActivityAsyncXblMultiplayerCreateSearchHandleAsync