Partager via


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

HRESULT XblMultiplayerActivityUpdateRecentPlayers(  
         XblContextHandle xblContext,  
         const XblMultiplayerActivityRecentPlayerUpdate* updates,  
         size_t updatesCount  
)  

Parameters

xblContext   _In_
Type: XblContextHandle

Xbox Live context for the local user.

updates   _In_reads_(updatesCount)
Type: XblMultiplayerActivityRecentPlayerUpdate*

List of 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.

Recent-player updates are batched and uploaded by XSAPI by using the background queue provided during XblInitialize.

To force an immediate flush, call XblMultiplayerActivityFlushRecentPlayersAsync.

Requirements

Header: multiplayer_activity_c.h

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

See also

multiplayer_activity_c