Skip to main content

XblMultiplayerWriteSessionResult

获取 XblMultiplayerWriteSessionAsync 操作的结果。

语法

参数

async   _Inout_
类型:XAsyncBlock*
此操作的 AsyncBlock。 handle   _Out_
类型:XblMultiplayerSessionHandle*
回传本地多人游戏会话对象新实例的句柄。调用方必须通过调用 XblMultiplayerSessionCloseHandle 释放 XblMultiplayerSessionHandle。使用 XblMultiplayerSession* API 从该句柄中获取会话数据。如果不需要更新后的会话对象,传递 nullptr 将导致立即清理新的多人游戏会话对象。

返回值

类型:HRESULT 此 API 操作的 HRESULT 返回代码。如果出现网络错误或失败的 HTTP 状态代码(除非是 412(前置条件失败)),它将是一个失败的 HRESULT。412 会返回成功,因为服务同时返回最新会话状态,因此你必须调用 XblMultiplayerSessionWriteStatus() 获取写入状态,并调用 XblMultiplayerSession* API 从该句柄获取会话数据。

备注

请注意,如果你离开一个自己是最后一名成员的会话,且 sessionEmptyTimeout 等于 0,则该会话将被立即删除。调用 XblMultiplayerSessionWriteStatus() 获取写入状态。

要求

头文件: multiplayer_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

multiplayer_c
最后修改于 2026年8月13日