XblMultiplayerWriteSessionByHandleAsync
セッションへの指定されたハンドルを使用して、新規または更新されたマルチプレイヤー セッションをサービスに書き込みます。
構文
HRESULT XblMultiplayerWriteSessionByHandleAsync(
XblContextHandle xblContext,
XblMultiplayerSessionHandle multiplayerSession,
XblMultiplayerSessionWriteMode writeMode,
const char* handleId,
XAsyncBlock* async
)
パラメーター
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 識別子です。 通常、呼び出し元は handleId を他のプレイヤーの XblMultiplayerGetActivitiesForUsersAsync() API から、または招待から取得します。 ハンドルが指すセッションの有効期間よりもハンドル自身の有効期間が短かったために、マルチプレイヤー セッション オブジェクトに有効な XblMultiplayerSessionReference がない場合にのみ、このメソッドを使用します。
要件
ヘッダー: multiplayer_c.h
ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib