> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerSetTransferHandleAsync

> XblMultiplayerSetTransferHandleAsync

# XblMultiplayerSetTransferHandleAsync

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

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerSetTransferHandleAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionReference targetSessionReference,  
         XblMultiplayerSessionReference originSessionReference,  
         XAsyncBlock* async  
)  
```

### Parameters

*xblContext*   \_In\_\
Type: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

XBOX live context for the local user.

*targetSessionReference*   \_In\_\
Type: [XblMultiplayerSessionReference](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

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

*originSessionReference*   \_In\_\
Type: [XblMultiplayerSessionReference](/reference/live/xsapi-c/multiplayer_c/structs/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](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSetTransferHandleResult](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersettransferhandleresult.md)
- [Multiplayer tasks](/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [XblMultiplayerSetActivityAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersetactivityasync.md)
- [XblMultiplayerActivitySetActivityAsync](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitysetactivityasync.md)
- [XblMultiplayerCreateSearchHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleasync.md)