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

Obtiene un objeto de sesión con todos sus atributos desde el servidor, dado un identificador de sesión (handle id).

## Sintaxis

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

### Parámetros

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

Contexto de XBOX live del usuario local.

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

Un identificador multijugador (handle id), que identifica la sesión de forma única.

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

El AsyncBlock para esta operación.

### Valor devuelto

Tipo: HRESULT

Código de retorno HRESULT para esta operación de API.

## Comentarios

Un identificador (handle) es un puntero del lado del servicio a una sesión. El handleId es un identificador GUID del identificador. Normalmente, los autores de la llamada obtienen el handleId del XblMultiplayerActivityDetails de otro jugador o de una invitación.

## Llamada REST

Llama a GET /handles/{handleId}/session

## Requisitos

**Encabezado:** multiplayer\_c.h

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

## Documentación conceptual

* [Recepción de invitaciones](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## Consulte también

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


## Related topics

- [XblMultiplayerGetSessionByHandleResult](/es/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleresult.md)
- [Recepción de invitaciones](/es/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)
- [Migración de MPSD a PlayFab Multiplayer y MPA](/es/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Preguntas frecuentes y solución de problemas de multijugador](/es/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)
- [XblMultiplayerGetSessionAsync](/es/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionasync.md)