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

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

## 语法

```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](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync)\
[XblMultiplayerWriteSessionByHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync)

## 要求

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

## 另请参阅

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


## Related topics

- [XblMultiplayerWriteSessionAsync](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [XblMultiplayerWriteSessionByHandleAsync](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)
- [XblMultiplayerManagerLobbySessionSetSynchronizedHost](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost.md)
- [XblMultiplayerManagerGameSessionSetSynchronizedHost](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md)
- [XblMultiplayerManagerGameSessionSetSynchronizedProperties](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties.md)