Skip to main content

XblMultiplayerActivityGetActivityAsync

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

Syntax

Parameters

xblContext   _In_
Type: 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 콜백 내부에서 또는 비동기 작업이 완료된 후에 XblMultiplayerActivityGetActivityResultSizeXblMultiplayerActivityGetActivityResult를 호출하세요.

이 함수가 어떻게 사용되는지 보려면 멀티플레이어 활동 예제 코드Activities 섹션에서 “Getting activities”를 참조하세요.

멀티플레이어 활동에 대한 자세한 내용은 Activities를 참조하세요.

REST Call

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

Requirements

Header: multiplayer_activity_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

See also

multiplayer_activity_c
마지막 수정일 2026년 8월 24일