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

# XblMultiplayerActivityFlushRecentPlayersAsync

> XblMultiplayerActivityFlushRecentPlayersAsync

# XblMultiplayerActivityFlushRecentPlayersAsync

立即将任何挂起的最近玩家更新写入 XBOX Live。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerActivityFlushRecentPlayersAsync(  
         XblContextHandle xblContext,  
         XAsyncBlock* async  
)  
```

### 参数

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

本地用户的 XBOX Live 上下文。

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

此操作的 `XAsyncBlock`。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

调用此 API 是可选的；更新会定期从后台任务队列上传。<br /><br /> 使用此 API 时，上传会在此调用中提供的任务队列上进行。<br /><br /> 若要获取异步操作的结果，请在 `XAsyncBlock` 回调内或 `XAsyncBlock` 完成后调用 [XAsyncGetStatus](/reference/system/xasync/functions/xasyncgetstatus)。<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#recent-players)部分。

## REST 调用

调用 POST /titles/{titleId}/recentplayers

## 要求

**头文件：** 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

- [XblMultiplayerActivityUpdateRecentPlayers](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivityupdaterecentplayers.md)
- [Multiplayer Activity 示例代码](/zh-CN/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)
- [从 MPSD 迁移到 PlayFab Multiplayer 和 MPA](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [XblMultiplayerActivityRecentPlayerUpdate](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityrecentplayerupdate.md)
- [XblMultiplayerActivityEncounterType](/zh-CN/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityencountertype.md)