Skip to main content

​
GET (/handles/)

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

​
备注

此 HTTP/REST 方法获取指定句柄的用户当前活动的会话。返回值为会话对象及其所有属性。此方法可以由 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync 包装。 此方法的调用方从玩家的 MultiplayerActivityDetails 对象获取句柄 ID。或者，调用方在用户接受游戏邀请之后从协议激活中获取该 ID。

​
URI 参数

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

​
HTTP 状态代码

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

​
请求正文

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

​
响应正文

请参阅 MultiplayerSession (JSON) 中的响应结构。

​
另请参阅

上级
/handles/
Last modified on October 19, 2026