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

Obtient un objet de session avec tous ses attributs depuis le serveur, à partir d'un ID de handle de session.

## Syntaxe

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

### Paramètres

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

Contexte XBOX Live pour l'utilisateur local.

*handleId*   \_In\_\
Type : char\*

Un ID de handle multijoueur, qui identifie la session de manière unique.

*async*   \_In\_\
Type : XAsyncBlock\*

L'AsyncBlock pour cette opération.

### Valeur de retour

Type : HRESULT

Code de retour HRESULT pour cette opération d'API.

## Remarques

Un handle est un pointeur côté service vers une session. Le handleId est un identificateur GUID du handle. Les appelants obtiennent généralement le handleId à partir des XblMultiplayerActivityDetails d'un autre joueur ou d'une invitation.

## Appel REST

Appelle GET /handles/{handleId}/session

## Configuration requise

**En-tête :** multiplayer\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Documentation conceptuelle

* [Réception d'invitations](/fr/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## Voir aussi

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


## Related topics

- [XblMultiplayerGetSessionByHandleResult](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleresult.md)
- [Réception d'invitations](/fr/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)
- [Passer de MPSD à PlayFab Multiplayer et MPA](/fr/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [FAQ et résolution des problèmes multijoueurs](/fr/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)
- [XblMultiplayerGetSessionResult](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionresult.md)