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

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

## 语法

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

### 参数

*xblContext*   \_In\_\
类型：[XblContextHandle](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

本地用户的 XBOX Live 上下文。

*activityInfo*   \_In\_\
类型：[XblMultiplayerActivityInfo\*](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)

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

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

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

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

此操作的 `XAsyncBlock`。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

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

## REST 调用

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

## 要求

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

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

## 另请参阅

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


## Related topics

- [XblMultiplayerActivityPlatform](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform.md)
- [XblMultiplayerActivityInfo](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)
- [XblMultiplayerActivityJoinRestriction](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction.md)
- [multiplayer_activity_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members.md)
- [XGameUiShowMultiplayerActivityGameInviteAsync](https://docs.xbox.com/zh-CN/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteasync.md)