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

# XblMultiplayerSessionJoin

> XblMultiplayerSessionJoin

# XblMultiplayerSessionJoin

将本地用户加入会话，并将用户设置为活动。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerSessionJoin(  
         XblMultiplayerSessionHandle handle,  
         const char* memberCustomConstantsJson,  
         bool initializeRequested,  
         bool joinWithActiveStatus  
)  
```

### 参数

*handle*   \_In\_\
类型: [XblMultiplayerSessionHandle](/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

多人游戏会话的句柄。

*memberCustomConstantsJson*   \_In\_opt\_z\_\
类型: char\*

要为此成员设置的自定义常量。这是唯一可以设置成员常量的时机。

*initializeRequested*   \_In\_\
类型: bool

如果系统应执行托管的初始化，则为 True，否则为 false。

*joinWithActiveStatus*   \_In\_\
类型: bool

如果玩家应以活动状态加入，则为 True。

### 返回值

类型: HRESULT

此 API 操作的 HRESULT 返回码。

## 要求

**头文件:** multiplayer\_c.h

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

## 概念文档

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

## 另请参阅

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


## Related topics

- [XblMultiplayerSessionMembers](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionmembers.md)
- [接收邀请](/zh-CN/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)
- [从 MPSD 迁移到 PlayFab Multiplayer 和 MPA](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [多人游戏常见问题和故障排除](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)
- [多人游戏任务](/zh-CN/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)