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

Joins the local user to the session, sets the user to active.

## Syntax

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

### Parameters

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

Handle to the multiplayer session.

*memberCustomConstantsJson*   \_In\_opt\_z\_\
Type: char\*

The custom constants to set for this member. This is the only time the member's constants can be set.

*initializeRequested*   \_In\_\
Type: bool

True if the system should perform managed initialization, and false otherwise.

*joinWithActiveStatus*   \_In\_\
Type: bool

True if player should join with active status.

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Requirements

**Header:** multiplayer\_c.h

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

## Conceptual documentation

* [Receiving invites](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## See also

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


## Related topics

- [XblMultiplayerSessionMembers](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionmembers.md)
- [Moving from MPSD to PlayFab Multiplayer and MPA](/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Receiving invites](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)
- [Multiplayer tasks](/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [Multiplayer FAQ and troubleshooting](/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)