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

# XblMultiplayerActivitySetActivityAsync

> XblMultiplayerActivitySetActivityAsync

# XblMultiplayerActivitySetActivityAsync

Définit ou met à jour l'activité multijoueur d'un utilisateur local.

## Syntaxe

```cpp theme={null}
HRESULT XblMultiplayerActivitySetActivityAsync(  
         XblContextHandle xblContext,  
         const XblMultiplayerActivityInfo* activityInfo,  
         bool allowCrossPlatformJoin,  
         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 de l'utilisateur local.

*activityInfo*   \_In\_\
Type : [XblMultiplayerActivityInfo\*](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)

Informations sur l'activité. Les champs `maxPlayers` et `currentPlayers` sont facultatifs; ils sont ignorés s'ils sont définis à 0. La valeur du champ `platform` est ignorée; XSAPI définit automatiquement l'activité sur la plateforme locale appropriée.

*allowCrossPlatformJoin*   \_In\_\
Type : bool

True si l'activité doit pouvoir être rejointe sur les autres plateformes prises en charge par le titre.

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

`XAsyncBlock` pour cette opération.

### Valeur de retour

Type : HRESULT

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

## Remarques

Lorsqu'un titre démarre une expérience multijoueur ou s'y joint, il doit créer une activité. Cela permet à l'interpréteur de commandes (shell) et aux autres joueurs de votre titre de voir l'activité du joueur. Votre titre peut permettre à d'autres joueurs de se joindre à la partie en cours. Si un joueur souhaite se joindre à une activité de votre titre et que celui-ci n'est pas en cours d'exécution, le titre est activé et la chaîne de connexion lui est transmise. \
\
 Pour voir comment cette fonction est utilisée, consultez « Définition d'une activité » dans la section [Activités](https://docs.xbox.com/fr-CA/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md#activities) de [Exemple de code pour Multiplayer Activity](https://docs.xbox.com/fr-CA/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md).

## Appel REST

Appelle PUT /titles/{titleId}/users/{xuid}/activites

## Configuration requise

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

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

## Voir aussi

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


## Related topics

- [XblMultiplayerActivityPlatform](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform.md)
- [XblMultiplayerActivityInfo](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)
- [XblMultiplayerActivityJoinRestriction](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction.md)
- [multiplayer_activity_c](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members.md)
- [Passer de MPSD à PlayFab Multiplayer et MPA](https://docs.xbox.com/fr-CA/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)