> ## 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 用户 ID (XUID) 数组。

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

`xuids` 指定的数组中的元素数量。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

此函数将 `xuids` 中指定的 XBOX 用户列表加入到由 `sessionName` 中指定的全局唯一会话名称标识的游戏会话中。你可以从游戏的第三方匹配结果中获取全局唯一会话名称，并且应为需要加入游戏的所有客户端调用此函数。<br />此函数的结果作为多人游戏事件传递，事件类型设置为 `XblMultiplayerEventType::JoinGameCompleted`。你可以调用 [XblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) 检索多人游戏事件。<br />尝试加入游戏会话时，如果服务器已满，服务将返回 `HTTP_E_STATUS_BAD_REQUEST`。<br />加入后，你可以通过调用 [XblMultiplayerManagerGameSessionSetProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties) 或 [XblMultiplayerManagerGameSessionSetSynchronizedProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties) 设置游戏会话的属性，或者你可以通过调用 [XblMultiplayerManagerGameSessionSetSynchronizedHost](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost) 设置游戏会话的主机。

## 要求

**头文件：** multiplayer\_manager\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

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


## Related topics

- [XblMultiplayerManagerJoinGameFromLobby](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.md)
- [XblMultiplayerManagerLeaveGame](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerleavegame.md)
- [XblMultiplayerManagerJoinLobby](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)
- [Multiplayer Manager API 概述](/zh-CN/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)