Skip to main content

XblMultiplayerWriteSessionByHandleAsync

指定されたセッションへのハンドルを使用して、新規または更新されたマルチプレイヤー セッションをサービスに書き込みます。

構文

パラメーター

xblContext   _In_
型: XblContextHandle
ローカル ユーザーの XBOX live コンテキスト。 multiplayerSession   _In_
型: XblMultiplayerSessionHandle
書き込む変更内容で変更された MultiplayerSession オブジェクト。 writeMode   _In_
型: XblMultiplayerSessionWriteMode
書き込み操作の種類。 handleId   _In_
型: char*
セッションの書き込み時に使用するハンドルの ID。 async   _In_
型: XAsyncBlock*
この操作の AsyncBlock。

戻り値

型: HRESULT この API 操作の HRESULT リターン コード。

解説

ハンドルは、セッションに対するサービス側のポインタです。ハンドル ID は、ハンドルの GUID 識別子です。呼び出し元は通常、XblMultiplayerGetActivitiesForUsersAsync() API を介して別のプレイヤーの XblMultiplayerActivityDetails から、または招待から handleId を取得します。ハンドルの有効期間は、それが指すセッションの有効期間より短くなる可能性があるため、マルチプレイヤー セッション オブジェクトが有効な XblMultiplayerSessionReference を持たない場合にのみ、このメソッドを使用してください。

要件

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

概念ドキュメント

関連項目

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