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

擷取以控制代碼識別碼指定的控制代碼。

> **重要：**\
> 此方法由 2015 多人遊戲使用，僅適用於該多人遊戲版本及更新版本。其適用於範本合約 104/105 或更新版本，且每個要求都需要 X-Xbl-Contract-Version: 104/105 或更新版本的標頭元素。

* [備註](#ID4ET)
* [URI 參數](#ID4EDB)
* [HTTP 狀態碼](#ID4EOB)
* [要求本文](#ID4EUB)
* [回應本文](#ID4E5B)

<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="ID4EUB" />

## 要求本文

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

<a id="ID4E5B" />

## 回應本文

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

<a id="ID4EKC" />

## 另請參閱

<a id="ID4EMC" />

##### 上層

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


## Related topics

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