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

# XblMultiplayerManagerJoinGameFromLobby

> XblMultiplayerManagerJoinGameFromLobby

# XblMultiplayerManagerJoinGameFromLobby

로비 세션에 대한 새 게임 세션을 만들거나 로비 세션에 대한 게임 세션이 이미 있는 경우 기존 게임 세션에 참가합니다.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerManagerJoinGameFromLobby(  
         const char* sessionTemplateName  
)  
```

### Parameters

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

게임 세션의 기반이 될 세션 템플릿의 이름입니다.

### Return value

Type: HRESULT

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

## Remarks

이 함수는 게임 세션이 아직 존재하지 않는 경우 새 게임 세션을 만들고 로비 세션의 현재 멤버를 게임 세션에 추가합니다. 게임 세션이 이미 만들어진 후 새 사용자가 로비 세션에 참가하면 이 함수는 로비 세션의 전송 핸들을 사용하여 Multiplayer Session Directory(MPSD)에서 기존 게임 세션을 찾은 다음, 해당 전송 핸들을 사용하여 새 사용자를 게임 세션에 추가합니다. 자세한 내용은 [Multiplayer concepts overview](/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts)를 참조하세요. 이 함수를 호출하기 전에 [XblMultiplayerManagerInitialize](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize)가 호출되지 않은 이유 등으로 로비 세션이 존재하지 않는 경우 오류가 발생합니다. 매치메이킹이 진행 중인 경우에도 오류가 발생합니다. 이 함수는 기존 로비 세션 속성을 게임 세션으로 마이그레이션하지 않습니다. <br />이 함수의 결과는 이벤트 유형이 `XblMultiplayerEventType::JoinGameCompleted`로 설정된 멀티플레이어 이벤트로 전달됩니다. [XblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork)를 호출하여 멀티플레이어 이벤트를 검색할 수 있습니다.  <br />로비 세션에 참가하려고 할 때 서버가 가득 차면 서비스는 `HTTP_E_STATUS_BAD_REQUEST`를 반환합니다.  <br />참가 후 [XblMultiplayerManagerGameSessionSetProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties) 또는 [XblMultiplayerManagerGameSessionSetSynchronizedProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties)를 호출하여 게임 세션의 속성을 설정하거나, [XblMultiplayerManagerGameSessionSetSynchronizedHost](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost)를 호출하여 게임 세션의 호스트를 설정할 수 있습니다.

## Requirements

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

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

## 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)\
[XblMultiplayerManagerJoinGame](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame)\
[XblMultiplayerManagerJoinLobby](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby)


## Related topics

- [XblMultiplayerManagerJoinLobby](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)
- [XblMultiplayerManagerLeaveGame](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerleavegame.md)
- [Multiplayer Manager를 사용하여 친구와 멀티플레이어 플레이](/ko/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-friends.md)