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

<a id="ID4ET" />

## 備註

此 HTTP/REST 方法會使用提供的工作階段服務端指標 (控制代碼)，從伺服器擷取工作階段物件。傳回值為工作階段物件及其所有屬性。此方法可由 **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync** 包裝。

此方法的呼叫者會從玩家的 **MultiplayerActivityDetails** 物件取得控制代碼識別碼。或者，呼叫者會在使用者接受遊戲邀請後，從通訊協定啟用取得該識別碼。

<a id="ID4EDB" />

## URI 參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- |
\| handleId| GUID| 工作階段控制代碼的唯一識別碼。|

<a id="ID4EOB" />

## HTTP 狀態碼

服務會傳回適用於 MPSD 的 HTTP 狀態碼。

<a id="ID4EVB" />

## 要求本文

此要求的本文中不會傳送任何物件。

<a id="ID4E6B" />

## 回應本文

請參閱 [MultiplayerSession (JSON)](/zh-TW/reference/live/rest/json/json-multiplayersession) 中的回應結構。

<a id="ID4EIC" />

## 另請參閱

<a id="ID4EKC" />

##### 上層

[/handles/{handleId}/session](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession)


## Related topics

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