> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerSessionWriteMode

> XblMultiplayerSessionWriteMode

# XblMultiplayerSessionWriteMode

定义指示在创建或写入多人游戏会话时使用的模式的值。

## 语法

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

## 常量

| 常量 | 说明 |
| - | - |
| CreateNew | 创建多人游戏会话。如果会话已存在，则失败。 |
| UpdateOrCreateNew | 更新或创建会话。不关心会话是否存在。 |
| UpdateExisting | 更新现有多人游戏会话。如果会话不存在，则失败。 |
| SynchronizedUpdate | 更新现有多人游戏会话。如果本地会话上的 ETag 与服务器上的 ETag 不匹配，则失败并返回 HTTP\_E\_STATUS\_PRECOND\_FAILED（HTTP 状态 412）。如果会话不存在，则失败。 |

## 参数用途

[XblMultiplayerWriteSessionAsync](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)\
[XblMultiplayerWriteSessionByHandleAsync](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)

## 要求

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

## 另请参阅

[multiplayer\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members.md)


## Related topics

- [XblMultiplayerWriteSessionAsync](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [XblMultiplayerWriteSessionByHandleAsync](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)
- [XblMultiplayerManagerLobbySessionSetSynchronizedHost](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost.md)
- [XblMultiplayerManagerGameSessionSetSynchronizedHost](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md)
- [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties.md)