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

# 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](/fr-CA/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Contexte XBOX Live de l'utilisateur local.

*activityInfo*   \_In\_\
Type : [XblMultiplayerActivityInfo\*](/fr-CA/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo)

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. <br /><br /> Pour voir comment cette fonction est utilisée, consultez « Définition d'une activité » dans la section [Activités](/fr-CA/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#activities) de [Exemple de code pour Multiplayer Activity](/fr-CA/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to).

## 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](/fr-CA/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members)


## Related topics

- [XblMultiplayerActivitySetActivityAsync](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitysetactivityasync.md)
- [XblMultiplayerActivityPlatform](/es/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform.md)