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

# XblMultiplayerSessionCreateHandle

> XblMultiplayerSessionCreateHandle

# XblMultiplayerSessionCreateHandle

创建新的本地多人游戏会话。

## 语法

```cpp theme={null}
XblMultiplayerSessionHandle XblMultiplayerSessionCreateHandle(  
         uint64_t xuid,  
         const XblMultiplayerSessionReference* sessionReference,  
         const XblMultiplayerSessionInitArgs* initArgs  
)  
```

### 参数

*xuid*   \_In\_\
类型: uint64\_t

创建此会话的用户的 XBOX 用户 ID。

*sessionReference*   \_In\_opt\_\
类型: [XblMultiplayerSessionReference\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

唯一标识会话的引用。

*initArgs*   \_In\_opt\_\
类型: [XblMultiplayerSessionInitArgs\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessioninitargs)

用于初始化会话的其他参数。如果包含这些参数，则还必须包含 sessionReference。

### 返回值

类型: XblMultiplayerSessionHandle

本地多人游戏会话的句柄。

## 备注

您必须在此之后调用 [XblMultiplayerWriteSessionAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync) 才能将批处理的本地更改写入服务。如果在不调用 XblMultiplayerWriteSessionAsync 的情况下调用此函数，将仅创建本地会话对象，但不会将其提交到服务。当不再需要本地会话对象时，请调用 [XblMultiplayerSessionCloseHandle](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionclosehandle)。

## 要求

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

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

## 另请参阅

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


## Related topics

- [多人游戏任务](/zh-CN/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [从 MPSD 迁移到 PlayFab Multiplayer 和 MPA](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [XblMultiplayerCreateSearchHandleAsync](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleasync.md)
- [XblMultiplayerSessionReferenceCreate](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionreferencecreate.md)
- [XblMultiplayerSessionDuplicateHandle](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionduplicatehandle.md)