XblMultiplayerSetTransferHandleAsync

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

Syntax

HRESULT XblMultiplayerSetTransferHandleAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionReference targetSessionReference,  
         XblMultiplayerSessionReference originSessionReference,  
         XAsyncBlock* async  
)  

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.142.C.lib or Microsoft.Xbox.Services.143.C.lib

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

Syntax

Parameters

Return value

Remarks

Requirements

See also

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​See also

Syntax

Parameters

Return value

Remarks

Requirements

See also