Skip to main content

​
XblMultiplayerWriteSessionAsync

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

​
語法

​
參數

xblContext   _In_
類型：XblContextHandle 本機使用者的 XBOX Live 內容。 multiplayerSession   _In_
類型：XblMultiplayerSessionHandle 已使用要寫入之變更修改過的 MultiplayerSession 物件。 writeMode   _In_
類型：XblMultiplayerSessionWriteMode 寫入作業的類型。 async   _Inout_
類型：XAsyncBlock* 此作業的 AsyncBlock。

​
傳回值

類型：HRESULT 此 API 作業的 HRESULT 傳回碼。

​
備註

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

​
REST 呼叫

呼叫 V105 PUT /serviceconfigs//sessionTemplates//sessions/

​
需求

標頭： multiplayer_c.h 程式庫： Microsoft.Xbox.Services.14x.GDK.C.lib

​
另請參閱

multiplayer_c
Last modified on October 6, 2026