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

Écrit une session multijoueur nouvelle ou mise à jour dans le service, au moyen du handle spécifié de la session.

## Syntaxe

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

### Paramètres

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

Contexte XBOX Live pour l'utilisateur local.

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

Objet MultiplayerSession qui a été modifié avec les changements à écrire.

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

Type d'opération d'écriture.

*handleId*   \_In\_\
Type : char\*

ID du handle à utiliser lors de l'écriture de la session.

*async*   \_In\_\
Type : XAsyncBlock\*

AsyncBlock pour cette opération.

### Valeur de retour

Type : HRESULT

Code de retour HRESULT pour cette opération d'API.

## Remarques

Un handle est un pointeur côté service vers une session. L'ID du handle est un identificateur GUID du handle. Les appelants obtiennent généralement le handleId à partir des XblMultiplayerActivityDetails d'un autre joueur au moyen de l'API XblMultiplayerGetActivitiesForUsersAsync(), ou à partir d'une invitation. Utilisez cette méthode uniquement si votre objet de session multijoueur n'a pas de XblMultiplayerSessionReference valide, car la durée de vie d'un handle peut être plus courte que celle de la session vers laquelle il pointe.

## Configuration requise

**En-tête :** multiplayer\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Documentation conceptuelle

* [Réception d'invitations](/fr-CA/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## Voir aussi

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


## Related topics

- [XblMultiplayerWriteSessionByHandleAsync](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)
- [XblMultiplayerWriteSessionAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [XblMultiplayerSessionWriteMode](/es/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)