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

핸들 ID로 지정된 핸들을 검색합니다.

> **중요:**\
> 이 메서드는 2015 멀티플레이어에서 사용되며 해당 멀티플레이어 버전 이상에만 적용됩니다. 템플릿 계약 104/105 이상과 함께 사용하도록 설계되었으며, 모든 요청에 X-Xbl-Contract-Version: 104/105 이상의 헤더 요소가 필요합니다.

* [설명](#ID4ET)
* [URI 매개 변수](#ID4EDB)
* [HTTP 상태 코드](#ID4EOB)
* [요청 본문](#ID4EUB)
* [응답 본문](#ID4E5B)

## 설명

이 HTTP/REST 메서드는 지정된 핸들에 대해 세션에서 사용자의 현재 활동을 가져옵니다. 반환 값은 모든 특성을 포함한 세션 개체입니다. 이 메서드는 **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync**로 래핑될 수 있습니다.

이 메서드의 호출자는 플레이어의 **MultiplayerActivityDetails** 개체에서 핸들 ID를 얻습니다. 또는 사용자가 게임 초대를 수락한 후 프로토콜 활성화에서 ID를 가져옵니다.

## URI 매개 변수

\| 매개 변수| 형식| 설명|
\| --- | --- | --- | --- |
\| handleId| GUID| 세션 핸들의 고유 ID입니다.|

## HTTP 상태 코드

서비스는 MPSD에 적용되는 HTTP 상태 코드를 반환합니다.

## 요청 본문

이 요청의 본문에는 개체가 전송되지 않습니다.

## 응답 본문

[MultiplayerSession (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-multiplayersession)의 응답 구조를 참조하십시오.

## 함께 보기

##### 상위

[/handles/{handleId}](https://devdocs.xbox.com/ko/reference/live/rest/uri/sessiondirectory/uri-handleshandleid)


## Related topics

- [XblMultiplayerGetSessionByHandleAsync](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleasync.md)
- [XblMultiplayerWriteSessionByHandleAsync](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)