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

플레이어의 최근 플레이어 목록에 추가합니다. 조우한 사용자가 이미 목록에 있는 경우 기존 최근 플레이어 항목을 업데이트합니다.

## 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 컨텍스트입니다.

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

최근 플레이어 목록에 추가할 [XblMultiplayerActivityRecentPlayerUpdate](/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityrecentplayerupdate) 개체 목록입니다.

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

`updates` 배열의 크기입니다.

### Return value

Type: HRESULT

이 API 작업의 HRESULT 반환 코드입니다.

## Remarks

이 호출은 단방향입니다. 호출자의 최근 플레이어 목록에만 영향을 줍니다. <br /><br /> 최근 플레이어 업데이트는 `XblInitialize` 중에 제공된 백그라운드 큐를 사용하여 XSAPI에 의해 일괄 처리되고 업로드됩니다. <br /><br /> 즉시 플러시하려면 [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](/ko/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityrecentplayerupdate.md)
- [Multiplayer Activity에 대한 예제 코드](/ko/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)
- [MPSD에서 PlayFab Multiplayer 및 MPA로 이동](/ko/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [XblMultiplayerActivityFlushRecentPlayersAsync](/ko/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivityflushrecentplayersasync.md)
- [XblMultiplayerActivityEncounterType](/ko/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityencountertype.md)
