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

# XblMultiplayerGetSessionByHandleAsync

> XblMultiplayerGetSessionByHandleAsync

# XblMultiplayerGetSessionByHandleAsync

Obtém do servidor um objeto de sessão com todos os seus atributos, com base em uma ID de identificador de sessão.

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerGetSessionByHandleAsync(  
         XblContextHandle xblContext,  
         const char* handleId,  
         XAsyncBlock* async  
)  
```

### Parâmetros

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

Contexto do XBOX Live para o usuário local.

*handleId*   \_In\_\
Tipo: char\*

Uma ID de identificador multijogador, que identifica exclusivamente a sessão.

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

O AsyncBlock para esta operação.

### Valor retornado

Tipo: HRESULT

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

## Comentários

Um identificador é um ponteiro do lado do serviço para uma sessão. O handleId é um identificador GUID do identificador. Normalmente, os chamadores obtêm o handleId a partir do XblMultiplayerActivityDetails de outro jogador ou de um convite.

## Chamada REST

Chama GET /handles/{handleId}/session

## Requisitos

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

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

## Documentação conceitual

* [Recebendo convites](/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## Confira também

[multiplayer\_c](/pt-BR/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerGetSessionByHandleResult](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleresult.md)
- [Recebendo convites](/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)
- [Migrando do MPSD para o PlayFab Multiplayer e o MPA](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Perguntas frequentes e solução de problemas de multiplayer](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)
- [XblMultiplayerGetSessionAsync](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionasync.md)