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

# XblMultiplayerActivityGetActivityAsync

> XblMultiplayerActivityGetActivityAsync

# XblMultiplayerActivityGetActivityAsync

사용자 집합에 대한 멀티플레이어 활동을 가져옵니다. 각 호출당 최대 30명의 사용자를 쿼리할 수 있습니다.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerActivityGetActivityAsync(  
         XblContextHandle xblContext,  
         const uint64_t* xuids,  
         size_t xuidsCount,  
         XAsyncBlock* async  
)  
```

### Parameters

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

로컬 사용자의 XBOX Live 컨텍스트입니다.

*xuids*   \_In\_reads\_(xuidsCount)\
Type: uint64\_t\*

멀티플레이어 활동을 가져올 XBOX 사용자 ID 목록입니다.

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

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

*async*   \_In\_\
Type: XAsyncBlock\*

이 작업에 대한 `XAsyncBlock`입니다.

### Return value

Type: HRESULT

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

## Remarks

결과를 가져오려면 `XAsyncBlock` 콜백 내부에서 또는 비동기 작업이 완료된 후에 [XblMultiplayerActivityGetActivityResultSize](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresultsize) 및 [XblMultiplayerActivityGetActivityResult](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresult)를 호출하세요. <br /><br /> 이 함수가 어떻게 사용되는지 보려면 [멀티플레이어 활동 예제 코드](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to)의 [Activities](/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to#activities) 섹션에서 “Getting activities”를 참조하세요. <br /><br /> 멀티플레이어 활동에 대한 자세한 내용은 [Activities](/services/xbox-services/multiplayer/mpa/concepts/live-mpa-activities)를 참조하세요.

## REST Call

POST /titles/{titleId}/activities/query를 호출합니다.

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

- [XblMultiplayerActivityGetActivityResultSize](/ko/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresultsize.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)
- [XblMultiplayerActivityGetActivityResult](/ko/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitygetactivityresult.md)
- [XblMultiplayerActivityDeleteActivityAsync](/ko/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitydeleteactivityasync.md)