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

# XblMultiplayerManagerJoinGame

> XblMultiplayerManagerJoinGame

# XblMultiplayerManagerJoinGame

使用全域唯一的工作階段名稱加入遊戲工作階段。

## 語法

```cpp theme={null}
HRESULT XblMultiplayerManagerJoinGame(  
         const char* sessionName,  
         const char* sessionTemplateName,  
         const uint64_t* xuids,  
         size_t xuidsCount  
)  
```

### 參數

*sessionName*   \_In\_z\_\
類型：char\*

遊戲工作階段的全域唯一工作階段名稱。

*sessionTemplateName*   \_In\_z\_\
類型：char\*

遊戲工作階段所依據的工作階段範本名稱。

*xuids*   \_In\_opt\_\
類型：uint64\_t\*

XBOX 使用者識別碼 (XUID) 的陣列，代表您要加入遊戲的使用者。

*xuidsCount*   \_In\_\
類型：size\_t

為 `xuids` 指定之陣列中的元素數目。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

此函式會將 `xuids` 中指定的 XBOX 使用者清單，加入由 `sessionName.` 中指定之全域唯一工作階段名稱所識別的遊戲工作階段。您可以從遊戲第三方配對的結果取得全域唯一的工作階段名稱，而且應該針對所有需要加入遊戲的用戶端呼叫此函式。<br />此函式的結果會以多人遊戲事件的形式傳遞，其事件類型設定為 `XblMultiplayerEventType::JoinGameCompleted`。您可以呼叫 [XblMultiplayerManagerDoWork](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) 來擷取多人遊戲事件。<br />嘗試加入遊戲工作階段時，如果伺服器已滿，服務會傳回 `HTTP_E_STATUS_BAD_REQUEST`。<br />加入之後，您可以呼叫 [XblMultiplayerManagerGameSessionSetProperties](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties) 或 [XblMultiplayerManagerGameSessionSetSynchronizedProperties](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties) 來設定遊戲工作階段的屬性，或呼叫 [XblMultiplayerManagerGameSessionSetSynchronizedHost](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost) 來設定遊戲工作階段的主機。

## 需求

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

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

## 另請參閱

[multiplayer\_manager\_c](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)


## Related topics

- [XblMultiplayerManagerJoinGame](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame.md)
- [XblMultiplayerManagerJoinGameFromLobby](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.md)