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

# XblMultiplayerManagerJoinLobby

> XblMultiplayerManagerJoinLobby

# XblMultiplayerManagerJoinLobby

XBOX 사용자를 로비 세션에 참가시킵니다.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerManagerJoinLobby(  
         const char* handleId,  
         XblUserHandle user  
)  
```

### Parameters

*handleId*   \_In\_z\_\
Type: char\*

로비 세션에 대한 활동 핸들입니다.

*user*   \_In\_\
Type: XblUserHandle

로비 세션에 참가하는 사용자의 사용자 핸들입니다.

### Return value

Type: HRESULT

이 API 작업에 대한 HRESULT 반환 코드입니다.

## Remarks

이 함수는 *user*에 지정된 XBOX 사용자를 *handleId*에 지정된 로비 세션에 참가시킵니다. 로비 세션의 활동 핸들은 일반적으로 게임 초대 또는 [XblMultiplayerGetActivitiesForUsersAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforusersasync)를 호출하여 얻은 다른 사용자의 [XblMultiplayerActivityDetails](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayeractivitydetails)의 `HandleId` 값에서 검색됩니다. 멀티플레이어 활동에 대한 자세한 내용은 [Activities](/services/xbox-services/multiplayer/mpa/concepts/live-mpa-activities)를 참조하세요. <br />이 함수의 결과는 이벤트 유형이 `XblMultiplayerEventType::JoinLobbyCompleted`로 설정된 멀티플레이어 이벤트로 전달됩니다. [XblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork)를 호출하여 멀티플레이어 이벤트를 검색할 수 있습니다.  <br />로비 세션에 참가하려고 할 때 서버가 가득 차면 서비스는 `HTTP_E_STATUS_BAD_REQUEST`를 반환합니다.  <br />참가 후 [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties)를 호출하여 로비 세션의 속성을 설정하거나, 로비 세션에 아직 호스트가 없는 경우 [XblMultiplayerManagerLobbySessionSetSynchronizedHost](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost)를 호출하여 로비 세션의 호스트를 설정할 수 있습니다.  <br />또한 [XblMultiplayerManagerLobbySessionInviteUsers](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers) 또는 [XblMultiplayerManagerLobbySessionInviteFriends](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends)를 호출하여 다른 사용자에게 초대를 보낼 수 있습니다. 로비 세션이 필요하지 않고 [XblMultiplayerManagerLobbySessionAddLocalUser](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser)를 호출하여 로컬 사용자를 추가하지 않은 경우, 대신 [XblMultiplayerManagerJoinGame](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame)을 호출하고 게임에 참가할 사용자 목록을 지정할 수 있습니다.

## Requirements

**Header:** multiplayer\_manager\_c.h

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

## Conceptual documentation

* [Receiving invites](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## See also

[multiplayer\_manager\_c](/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerJoinability](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinability)\
[XblMultiplayerManagerJoinGameFromLobby](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby)


## Related topics

- [XblMultiplayerManagerJoinGameFromLobby](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.md)
- [XblMultiplayerManagerLeaveGame](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerleavegame.md)
- [XblMultiplayerManagerLobbySessionInviteFriends](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends.md)
- [XblMultiplayerManagerLobbySessionInviteUsers](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)