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

# XblMultiplayerActivitySetActivityAsync

> XblMultiplayerActivitySetActivityAsync

# XblMultiplayerActivitySetActivityAsync

로컬 사용자에 대한 멀티플레이어 활동을 설정하거나 업데이트합니다.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerActivitySetActivityAsync(  
         XblContextHandle xblContext,  
         const XblMultiplayerActivityInfo* activityInfo,  
         bool allowCrossPlatformJoin,  
         XAsyncBlock* async  
)  
```

### Parameters

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

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

*activityInfo*   \_In\_\
Type: [XblMultiplayerActivityInfo\*](/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo)

활동에 대한 정보입니다. `maxPlayers` 및 `currentPlayers` 필드는 선택 사항이며 0으로 설정된 경우 무시됩니다. `platform` 필드의 값은 무시됩니다. XSAPI가 적절한 로컬 플랫폼에서 활동을 자동으로 설정합니다.

*allowCrossPlatformJoin*   \_In\_\
Type: bool

활동이 타이틀에서 지원하는 다른 플랫폼에서도 참여 가능해야 하는 경우 True입니다.

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

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

### Return value

Type: HRESULT

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

## Remarks

타이틀이 멀티플레이어 경험을 시작하거나 참여할 때 활동을 만들어야 합니다. 그러면 셸과 타이틀의 다른 플레이어 모두 플레이어의 활동을 볼 수 있습니다. 타이틀은 다른 플레이어가 진행 중인 게임에 참여하도록 허용할 수 있습니다. 플레이어가 타이틀의 활동에 참여하려고 하는데 타이틀이 실행 중이 아니면 타이틀이 활성화되고 연결 문자열이 전달됩니다. <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) 섹션에서 “Setting an activity”를 참조하세요.

## REST Call

PUT /titles/{titleId}/users/{xuid}/activites를 호출합니다.

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

- [XblMultiplayerActivityPlatform](/ko/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform.md)
- [XblMultiplayerActivityInfo](/ko/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)
- [XblMultiplayerActivityJoinRestriction](/ko/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction.md)
- [XGameUiShowMultiplayerActivityGameInviteAsync](/ko/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteasync.md)
- [MPSD에서 PlayFab Multiplayer 및 MPA로 이동](/ko/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)