Skip to main content

XblMultiplayerWriteSessionResult

XblMultiplayerWriteSessionAsync 操作の結果を取得します。

構文

パラメーター

async   _Inout_
型: XAsyncBlock*
この操作の AsyncBlock。 handle   _Out_
型: XblMultiplayerSessionHandle*
ローカル マルチプレイヤー セッション オブジェクトの新しいインスタンスへのハンドルを返します。XblMultiplayerSessionHandle は、呼び出し元が XblMultiplayerSessionCloseHandle を呼び出して解放する必要があります。XblMultiplayerSession* API を使用してハンドルからセッション データを取得します。更新されたセッション オブジェクトが不要な場合、nullptr を渡すと、新しいマルチプレイヤー セッション オブジェクトは直ちにクリーンアップされます。

戻り値

型: HRESULT この API 操作の HRESULT リターン コード。ネットワーク エラーまたは失敗の HTTP ステータス コードがあった場合、412 (Precondition Failed) 以外では失敗の HRESULT になります。412 の場合、サービスも最新のセッション状態を返すため成功となり、XblMultiplayerSessionWriteStatus() を呼び出して書き込み状態を取得し、XblMultiplayerSession* API を呼び出してハンドルからセッション データを取得する必要があります。

解説

自分が最後のメンバーであるセッションから退出し、sessionEmptyTimeout が 0 の場合、セッションは直ちに削除されることに注意してください。XblMultiplayerSessionWriteStatus() を呼び出して書き込み状態を取得します。

要件

ヘッダー: multiplayer_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

multiplayer_c
最終更新日 2026年8月13日