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

# XblMultiplayerWriteSessionResult

> XblMultiplayerWriteSessionResult

# XblMultiplayerWriteSessionResult

取得 XblMultiplayerWriteSessionAsync 作業的結果。

## 語法

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionResult(  
         XAsyncBlock* async,  



         XblMultiplayerSessionHandle* handle  
)  
```

### 參數

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

此作業的 AsyncBlock。

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

傳回本機多人遊戲工作階段物件新執行個體的控制代碼。呼叫端必須呼叫 [XblMultiplayerSessionCloseHandle](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/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](/zh-TW/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerWriteSessionAsync](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [多人遊戲工作](/zh-TW/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [XblMultiplayerWriteSessionByHandleResult](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleresult.md)
- [XblMultiplayerQuerySessionsResult](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerquerysessionsresult.md)
- [XblMultiplayerSessionWriteStatus](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionwritestatus.md)