> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerWriteSessionAsync

> XblMultiplayerWriteSessionAsync

# XblMultiplayerWriteSessionAsync

Écrit une session multijoueur nouvelle ou mise à jour dans le service. La session doit avoir une référence de session valide. Si elle n'a pas été créée avec une telle référence, utilisez plutôt XblMultiplayerWriteSessionByHandleAsync.

## Syntaxe

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

### Paramètres

*xblContext*   \_In\_\
Type : [XblContextHandle](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

Contexte XBOX Live pour l'utilisateur local.

*multiplayerSession*   \_In\_\
Type : [XblMultiplayerSessionHandle](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle.md)

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

*writeMode*   \_In\_\
Type : [XblMultiplayerSessionWriteMode](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)

Type d'opération d'écriture.

*async*   \_Inout\_\
Type : XAsyncBlock\*

AsyncBlock pour cette opération.

### Valeur de retour

Type : HRESULT

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

## Remarques

Dans le rappel asynchrone, appelez XblMultiplayerWriteSessionResult() pour obtenir un handle XblMultiplayerSessionHandle. Utilisez ce handle pour appeler XblMultiplayerSessionWriteStatus() afin d'obtenir l'état d'écriture. L'appel à XblMultiplayerWriteSessionAsync() échouera uniquement si les arguments qui lui sont transmis ne sont pas valides ou, dans de très rares cas, s'il n'a pas pu démarrer la tâche asynchrone.

## Appel REST

Appelle V105 PUT /serviceconfigs/{serviceConfigurationId}/sessionTemplates/{sessiontemplateName}/sessions/{sessionName}

## Configuration requise

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

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

## Voir aussi

[multiplayer\_c](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members.md)


## Related topics

- [XblMultiplayerSessionWriteMode](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)
- [XblMultiplayerWriteSessionResult](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionresult.md)
- [XblMultiplayerSessionWriteStatus](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionwritestatus.md)
- [XblMultiplayerWriteSessionByHandleResult](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleresult.md)
- [XblMultiplayerSessionCreateHandle](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncreatehandle.md)