跳轉到主要內容

XblMultiplayerWriteSessionResult

取得 XblMultiplayerWriteSessionAsync 作業的結果。

語法

參數

async   _Inout_
類型:XAsyncBlock*
此作業的 AsyncBlock。 handle   _Out_
類型:XblMultiplayerSessionHandle*
傳回本機多人遊戲工作階段物件新執行個體的控制代碼。呼叫端必須呼叫 XblMultiplayerSessionCloseHandle 以釋放 XblMultiplayerSessionHandle。使用 XblMultiplayerSession* API 從控制代碼取得工作階段資料。如果不需要更新後的工作階段物件,傳遞 nullptr 會使新的多人遊戲工作階段物件立即被清除。

傳回值

類型:HRESULT 此 API 作業的 HRESULT 傳回碼。如果發生網路錯誤或失敗的 HTTP 狀態碼,則會是失敗的 HRESULT,但 412 (Precondition Failed) 除外。由於服務也會傳回最新的工作階段狀態,因此 412 會傳回成功,您必須呼叫 XblMultiplayerSessionWriteStatus() 以取得寫入狀態,並呼叫 XblMultiplayerSession* API 從控制代碼取得工作階段資料。

備註

請注意,如果您離開的工作階段中您是最後一位成員,且 sessionEmptyTimeout 等於 0,則工作階段會立即被刪除。呼叫 XblMultiplayerSessionWriteStatus() 以取得寫入狀態。

需求

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

另請參閱

multiplayer_c
最後修改於 2026年10月6日