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

# XblMultiplayerGetSessionByHandleAsync

> XblMultiplayerGetSessionByHandleAsync

# XblMultiplayerGetSessionByHandleAsync

根據指定的工作階段控制代碼識別碼，從伺服器取得工作階段物件及其所有屬性。

## 語法

```cpp theme={null}
HRESULT XblMultiplayerGetSessionByHandleAsync(  
         XblContextHandle xblContext,  
         const char* handleId,  
         XAsyncBlock* async  
)  
```

### 參數

*xblContext*   \_In\_\
類型：[XblContextHandle](/zh-TW/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

本機使用者的 XBOX Live 內容。

*handleId*   \_In\_\
類型：char\*

可唯一識別工作階段的多人遊戲控制代碼識別碼。

*async*   \_In\_\
類型：XAsyncBlock\*

此作業的 AsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

控制代碼是指向工作階段的服務端指標。handleId 是控制代碼的 GUID 識別碼。呼叫者通常會從其他玩家的 XblMultiplayerActivityDetails 或邀請取得 handleId。

## REST 呼叫

呼叫 GET /handles/{handleId}/session

## 需求

**標頭：** multiplayer\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 概念文件

* [接收邀請](/zh-TW/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## 另請參閱

[multiplayer\_c](/zh-TW/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerGetSessionByHandleResult](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleresult.md)
- [接收邀請](/zh-TW/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)
- [從 MPSD 移至 PlayFab Multiplayer 與 MPA](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [多人遊戲常見問題集與疑難排解](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)
- [XblMultiplayerGetSessionAsync](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionasync.md)