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

# XblMultiplayerWriteSessionByHandleAsync

> XblMultiplayerWriteSessionByHandleAsync

# XblMultiplayerWriteSessionByHandleAsync

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

## 構文

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionByHandleAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         const char* handleId,  
         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)

書き込み操作の種類。

*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

## 概念ドキュメント

* [招待の受信](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## 関連項目

[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)
- [XblMultiplayerWriteSessionAsync](/ja-jp/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [招待の受信](/ja-jp/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)
- [Multiplayer Session Directory の概要](/ja-jp/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [MPSD から PlayFab Multiplayer と MPA への移行](/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)