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

为本地用户设置或更新多人游戏活动。

## 语法

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

### 参数

*xblContext*   \_In\_\
类型：[XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

本地用户的 XBOX Live 上下文。

*activityInfo*   \_In\_\
类型：[XblMultiplayerActivityInfo\*](/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo)

有关活动的信息。`maxPlayers` 和 `currentPlayers` 字段是可选的；如果设置为 0，则会被忽略。`platform` 字段的值会被忽略；XSAPI 会自动在相应的本地平台上设置活动。

*allowCrossPlatformJoin*   \_In\_\
类型：bool

如果活动应可在标题支持的其他平台上加入，则为 True。

*async*   \_In\_\
类型：XAsyncBlock\*

此操作的 `XAsyncBlock`。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

当标题启动或加入多人游戏体验时，它应创建一个活动。这样做可让 Shell 以及标题中的其他玩家看到该玩家的活动。你的标题可以允许其他玩家加入正在进行的游戏。如果玩家想加入你标题的某个活动而该标题未在运行，则会激活该标题并将连接字符串传递给它。<br /><br /> 若要了解如何使用此函数，请参阅[多人游戏活动的示例代码](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to)的[活动](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#activities)部分中的“设置活动”。

## REST 调用

调用 PUT /titles/{titleId}/users/{xuid}/activites

## 要求

**头文件：** multiplayer\_activity\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

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


## Related topics

- [XblMultiplayerActivityPlatform](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform.md)
- [XblMultiplayerActivityInfo](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)
- [XblMultiplayerActivityJoinRestriction](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction.md)
- [XGameUiShowMultiplayerActivityGameInviteAsync](/zh-CN/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteasync.md)
- [从 MPSD 迁移到 PlayFab Multiplayer 和 MPA](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)