GET (/handles/{handle-id})
检索句柄 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 状态代码
请求正文
对象不会在此请求的正文中发送。
响应正文
请参阅 MultiplayerSession (JSON) 中的响应结构。