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

# XblMultiplayerSetTransferHandleAsync

> XblMultiplayerSetTransferHandleAsync

# XblMultiplayerSetTransferHandleAsync

Os direitos de acesso que o chamador tem à sessão de origem são estendidos à sessão de destino.

## Sintaxe

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

### Parâmetros

*xblContext*   \_In\_\
Tipo: [XblContextHandle](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

Contexto do XBOX Live do usuário local.

*targetSessionReference*   \_In\_\
Tipo: [XblMultiplayerSessionReference](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference.md)

XblMultiplayerSessionReference de destino da sessão para a qual você deseja estender os direitos de acesso.

*originSessionReference*   \_In\_\
Tipo: [XblMultiplayerSessionReference](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference.md)

XblMultiplayerSessionReference de origem da sessão que concede acesso à sessão de destino.

*async*   \_In\_\
Tipo: XAsyncBlock\*

O AsyncBlock desta operação.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT desta operação de API.

## Comentários

Por exemplo, em um título com uma sessão de lobby e uma sessão de jogo, o título pode colocar um identificador de transferência que vincula o lobby ao jogo dentro da sessão de lobby. Os usuários convidados para o lobby também podem usar o identificador para ingressar na sessão de jogo. O identificador de transferência é excluído quando a sessão de destino é excluída.

## Requisitos

**Cabeçalho:** multiplayer\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Confira também

[multiplayer\_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members.md)


## Related topics

- [XblMultiplayerSetTransferHandleResult](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersettransferhandleresult.md)
- [Tarefas de multijogador](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [XblMultiplayerSetActivityAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersetactivityasync.md)
- [XblMultiplayerActivitySetActivityAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitysetactivityasync.md)
- [XblMultiplayerGetSearchHandlesAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesasync.md)
