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

# XblMultiplayerActivityUpdateRecentPlayers

> XblMultiplayerActivityUpdateRecentPlayers

# XblMultiplayerActivityUpdateRecentPlayers

Appends to a player's list of recent players. If an encountered user is already in the list, it updates the existing recent-player entry.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerActivityUpdateRecentPlayers(  
         XblContextHandle xblContext,  
         const XblMultiplayerActivityRecentPlayerUpdate* updates,  
         size_t updatesCount  
)  
```

### Parameters

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

XBOX Live context for the local user.

*updates*   \_In\_reads\_(updatesCount)\
Type: [XblMultiplayerActivityRecentPlayerUpdate\*](/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityrecentplayerupdate)

List of [XblMultiplayerActivityRecentPlayerUpdate](/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityrecentplayerupdate) objects to append to the recent players list.

*updatesCount*   \_In\_\
Type: size\_t

Size of the `updates` array.

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Remarks

This call is unidirectional; it only affects the caller's recent-players list. <br /><br /> Recent-player updates are batched and uploaded by XSAPI by using the background queue provided during `XblInitialize`. <br /><br /> To force an immediate flush, call [XblMultiplayerActivityFlushRecentPlayersAsync](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivityflushrecentplayersasync).

## Requirements

**Header:** multiplayer\_activity\_c.h

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

## See also

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


## Related topics

- [XblMultiplayerActivityRecentPlayerUpdate](/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityrecentplayerupdate.md)
- [Example code for Multiplayer Activity](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)
- [Moving from MPSD to PlayFab Multiplayer and MPA](/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [XblMultiplayerActivityFlushRecentPlayersAsync](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivityflushrecentplayersasync.md)
- [XblMultiplayerActivityEncounterType](/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityencountertype.md)