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

# XblMultiplayerWriteSessionAsync

> XblMultiplayerWriteSessionAsync

# XblMultiplayerWriteSessionAsync

將新的或已更新的多人遊戲工作階段寫入服務。工作階段必須具有有效的工作階段參考。如果建立時未使用工作階段參考，請改用 XblMultiplayerWriteSessionByHandleAsync。

## 語法

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         XAsyncBlock* async  
)  
```

### 參數

*xblContext*   \_In\_\
類型：[XblContextHandle](/zh-TW/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

本機使用者的 XBOX Live 內容。

*multiplayerSession*   \_In\_\
類型：[XblMultiplayerSessionHandle](/zh-TW/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

已使用要寫入之變更修改過的 MultiplayerSession 物件。

*writeMode*   \_In\_\
類型：[XblMultiplayerSessionWriteMode](/zh-TW/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode)

寫入作業的類型。

*async*   \_Inout\_\
類型：XAsyncBlock\*

此作業的 AsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

在非同步回呼中，呼叫 XblMultiplayerWriteSessionResult() 以取得 XblMultiplayerSessionHandle 控制代碼。使用該控制代碼呼叫 XblMultiplayerSessionWriteStatus() 以取得寫入狀態。只有在傳遞給 XblMultiplayerWriteSessionAsync() 的引數無效，或在極少數無法啟動非同步工作的情況下，此呼叫才會失敗。

## REST 呼叫

呼叫 V105 PUT /serviceconfigs/{serviceConfigurationId}/sessionTemplates/{sessiontemplateName}/sessions/{sessionName}

## 需求

**標頭：** 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

- [XblMultiplayerSessionWriteMode](/zh-TW/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)
- [XblMultiplayerWriteSessionResult](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionresult.md)
- [XblMultiplayerSessionWriteStatus](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionwritestatus.md)
- [XblMultiplayerWriteSessionByHandleResult](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleresult.md)
- [XblMultiplayerSessionCreateHandle](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncreatehandle.md)