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

# XblMultiplayerWriteSessionAsync

> XblMultiplayerWriteSessionAsync

# XblMultiplayerWriteSessionAsync

新規または更新されたマルチプレイヤー セッションをサービスに書き込みます。セッションには有効なセッション参照が必要です。セッション参照を持たずに作成された場合は、代わりに XblMultiplayerWriteSessionByHandleAsync を使用してください。

## 構文

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         XAsyncBlock* async  
)  
```

### パラメーター

*xblContext*   \_In\_\
型: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

ローカル ユーザーの XBOX live コンテキスト。

*multiplayerSession*   \_In\_\
型: [XblMultiplayerSessionHandle](/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

書き込む変更内容で変更された MultiplayerSession オブジェクト。

*writeMode*   \_In\_\
型: [XblMultiplayerSessionWriteMode](/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode)

書き込み操作の種類。

*async*   \_Inout\_\
型: XAsyncBlock\*

この操作の AsyncBlock。

### 戻り値

型: HRESULT

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

## 解説

非同期コールバックでは、XblMultiplayerWriteSessionResult() を呼び出して XblMultiplayerSessionHandle ハンドルを取得します。そのハンドルを使用して XblMultiplayerSessionWriteStatus() を呼び出し、書き込み状態を取得します。XblMultiplayerWriteSessionAsync() の呼び出しは、渡された引数が無効な場合、または非常にまれに非同期タスクを開始できなかった場合にのみ失敗します。

## REST 呼び出し

V105 PUT /serviceconfigs/{serviceConfigurationId}/sessionTemplates/{sessiontemplateName}/sessions/{sessionName} を呼び出します

## 要件

**ヘッダー:** multiplayer\_c.h

**ライブラリ:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 関連項目

[multiplayer\_c](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionWriteMode](/ja-jp/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)
- [XblMultiplayerWriteSessionResult](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionresult.md)
- [XblMultiplayerSessionWriteStatus](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionwritestatus.md)
- [XblMultiplayerWriteSessionByHandleResult](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleresult.md)
- [XblMultiplayerSessionCreateHandle](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncreatehandle.md)
