> ## 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 du serveur un objet de session avec tous ses attributs, à partir d'un identifiant de handle de session.

## Syntaxe

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

### Paramètres

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

Contexte XBOX Live de l'utilisateur local.

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

Un identifiant de handle multijoueur, qui identifie la session de façon 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 identifiant 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 des invitations](/fr-CA/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## Voir aussi

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


## Related topics

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