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

Define ou atualiza a atividade multijogador de um usuário local.

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerActivitySetActivityAsync(  
         XblContextHandle xblContext,  
         const XblMultiplayerActivityInfo* activityInfo,  
         bool allowCrossPlatformJoin,  
         XAsyncBlock* async  
)  
```

### Parâmetros

*xblContext*   \_In\_\
Tipo: [XblContextHandle](/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Contexto do XBOX Live para o usuário local.

*activityInfo*   \_In\_\
Tipo: [XblMultiplayerActivityInfo\*](/pt-BR/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo)

Informações sobre a atividade. Os campos `maxPlayers` e `currentPlayers` são opcionais; eles são ignorados se definidos como 0. O valor do campo `platform` é ignorado; o XSAPI define automaticamente a atividade na plataforma local apropriada.

*allowCrossPlatformJoin*   \_In\_\
Tipo: bool

True se for possível ingressar na atividade em outras plataformas compatíveis com o título.

*async*   \_In\_\
Tipo: XAsyncBlock\*

O `XAsyncBlock` para esta operação.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT para esta operação de API.

## Comentários

Quando um título inicia ou ingressa em uma experiência multijogador, ele deve criar uma atividade. Isso permite que tanto o shell quanto outros jogadores do seu título vejam a atividade do jogador. Seu título pode permitir que outros jogadores ingressem no jogo em andamento. Se um jogador quiser ingressar em uma atividade do seu título e ele não estiver em execução, o título será ativado e a cadeia de conexão será passada para ele. <br /><br /> Para ver como essa função é usada, consulte "Definir uma atividade" na seção [Atividades](/pt-BR/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#activities) de [Código de exemplo para o Multiplayer Activity](/pt-BR/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to).

## Chamada REST

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

## Requisitos

**Cabeçalho:** multiplayer\_activity\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Confira também

[multiplayer\_activity\_c](/pt-BR/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members)


## Related topics

- [XblMultiplayerActivityPlatform](/pt-BR/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform.md)
- [XblMultiplayerActivityInfo](/pt-BR/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)
- [XblMultiplayerActivityJoinRestriction](/pt-BR/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction.md)
- [XGameUiShowMultiplayerActivityGameInviteAsync](/pt-BR/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteasync.md)
- [Migrando do MPSD para o PlayFab Multiplayer e o MPA](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)