> ## 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 使用者識別碼。

*sessionReference*   \_In\_opt\_\
類型：[XblMultiplayerSessionReference\*](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

可唯一識別工作階段的參考。

*initArgs*   \_In\_opt\_\
類型：[XblMultiplayerSessionInitArgs\*](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessioninitargs)

用來初始化工作階段的其他引數。如果包含這些引數，也必須包含 sessionReference。

### 傳回值

類型：XblMultiplayerSessionHandle

本機多人遊戲工作階段的控制代碼。

## 備註

您必須在此之後呼叫 [XblMultiplayerWriteSessionAsync](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync)，將批次處理的本機變更寫入服務。如果呼叫此函式而未呼叫 XblMultiplayerWriteSessionAsync，則只會建立本機工作階段物件，而不會將其認可至服務。當不再需要本機工作階段物件時，請呼叫 [XblMultiplayerSessionCloseHandle](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionclosehandle)。

## 需求

**標頭：** multiplayer\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

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


## Related topics

- [多人遊戲工作](/zh-TW/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [從 MPSD 移至 PlayFab Multiplayer 與 MPA](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [XblMultiplayerCreateSearchHandleAsync](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleasync.md)
- [XblMultiplayerSessionReferenceCreate](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionreferencecreate.md)
- [XblMultiplayerSessionCloseHandle](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionclosehandle.md)