> ## 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

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](/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Contexto do XBOX Live do usuário local.

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

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

*originSessionReference*   \_In\_\
Tipo: [XblMultiplayerSessionReference](/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

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](/pt-BR/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

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