> ## 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/{handleId}/session)

> GET (/handles/{handleId}/session)

# GET (/handles/{handleId}/session)

获取指定句柄标识符的会话对象。

> **重要：**\
> 此方法由 2015 多人游戏使用，仅适用于该多人游戏版本及更高版本。它旨在与模板协定 104/105 或更高版本一起使用，并且每个请求都需要一个 X-Xbl-Contract-Version: 104/105 或更高版本的头元素。

* [备注](#ID4ET)
* [URI 参数](#ID4EDB)
* [HTTP 状态代码](#ID4EOB)
* [请求正文](#ID4EVB)
* [响应正文](#ID4E6B)

## 备注

此 HTTP/REST 方法使用提供的服务端指针（句柄）从服务器检索会话对象。返回值为会话对象及其所有属性。此方法可以由 **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync** 包装。

此方法的调用方从玩家的 **MultiplayerActivityDetails** 对象获取句柄 ID。或者，调用方在用户接受游戏邀请之后从协议激活中获取该 ID。

## URI 参数

\| 参数| 类型| 说明|
\| --- | --- | --- | --- |
\| handleId| GUID| 会话句柄的唯一 ID。|

## HTTP 状态代码

服务返回适用于 MPSD 的 HTTP 状态代码。

## 请求正文

此请求正文中不发送任何对象。

## 响应正文

请参阅 [MultiplayerSession (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-multiplayersession) 中的响应结构。

## 另请参阅

##### 上级

[/handles/{handleId}/session](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession)


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