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

# XblMultiplayerSessionWriteMode

> XblMultiplayerSessionWriteMode

# XblMultiplayerSessionWriteMode

Defines values that indicate the mode used when creating or writing to a multiplayer session.

## Syntax

```cpp theme={null}
enum class XblMultiplayerSessionWriteMode  : uint32_t  
{  
    CreateNew,  
    UpdateOrCreateNew,  
    UpdateExisting,  
    SynchronizedUpdate,  
}  
```

## Constants

| Constant           | Description                                                                                                                                                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| CreateNew          | Create a multiplayer session. Fails if the session already exists.                                                                                                                                                 |
| UpdateOrCreateNew  | Either update or create a session. Doesn't care whether the session exists.                                                                                                                                        |
| UpdateExisting     | Updates an existing multiplayer session. Fails if the session doesn't exist.                                                                                                                                       |
| SynchronizedUpdate | Updates an existing multiplayer session. Fails with HTTP\_E\_STATUS\_PRECOND\_FAILED (HTTP status 412) if the ETag on the local session doesn't match the ETag on the server. Fails if the session does not exist. |

## Argument of

[XblMultiplayerWriteSessionAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync)\
[XblMultiplayerWriteSessionByHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync)

## Requirements

**Header:** multiplayer\_c.h

## See also

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


## Related topics

- [XblMultiplayerWriteSessionAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [XblMultiplayerWriteSessionByHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)
- [XblMultiplayerManagerLobbySessionSetSynchronizedHost](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost.md)
- [XblMultiplayerManagerGameSessionSetSynchronizedHost](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md)
- [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties.md)