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

# GET (/handles/{handle-id})

> GET (/handles/{handle-id})

# GET (/handles/{handle-id})

Récupère les descripteurs spécifiés par ID de descripteur.

> **Important :**\
> Cette méthode est utilisée par le multijoueur 2015 et s'applique uniquement à cette version multijoueur et aux versions ultérieures. Elle est destinée à être utilisée avec le contrat de modèle 104/105 ou ultérieur et nécessite un élément d'en-tête X-Xbl-Contract-Version: 104/105 ou ultérieur dans chaque requête.

* [Remarques](#ID4ET)
* [Paramètres d'URI](#ID4EDB)
* [Codes d'état HTTP](#ID4EOB)
* [Corps de la requête](#ID4EUB)
* [Corps de la réponse](#ID4E5B)

<a id="ID4ET" />

## Remarques

Cette méthode HTTP/REST obtient l'activité actuelle des utilisateurs pour la session, pour les descripteurs spécifiés. Le retour est l'objet de session, avec tous ses attributs. Cette méthode peut être encapsulée par **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync**.

L'appelant de cette méthode obtient l'ID de descripteur à partir de l'objet **MultiplayerActivityDetails** d'un joueur. L'appelant peut aussi obtenir l'ID à partir d'une activation de protocole après qu'un utilisateur a accepté une invitation de jeu.

<a id="ID4EDB" />

## Paramètres d'URI

\| Paramètre| Type| Description|
\| --- | --- | --- | --- |
\| handleId| GUID| L'ID unique du descripteur de la session.|

<a id="ID4EOB" />

## Codes d'état HTTP

Le service retourne un code d'état HTTP tel qu'il s'applique au MPSD.

<a id="ID4EUB" />

## Corps de la requête

Aucun objet n'est envoyé dans le corps de cette requête.

<a id="ID4E5B" />

## Corps de la réponse

Consultez la structure de la réponse dans [MultiplayerSession (JSON)](/fr-CA/reference/live/rest/json/json-multiplayersession).

<a id="ID4EKC" />

## Voir aussi

<a id="ID4EMC" />

##### Parent

[/handles/{handleId}](/fr-CA/reference/live/rest/uri/sessiondirectory/uri-handleshandleid)


## Related topics

- [XblMultiplayerGetSessionByHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleasync.md)
- [XblMultiplayerWriteSessionByHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)