> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerManagerJoinGame

> XblMultiplayerManagerJoinGame

# XblMultiplayerManagerJoinGame

전역적으로 고유한 세션 이름을 사용하여 게임 세션에 참가합니다.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerManagerJoinGame(  
         const char* sessionName,  
         const char* sessionTemplateName,  
         const uint64_t* xuids,  
         size_t xuidsCount  
)  
```

### Parameters

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

게임 세션에 대한 전역적으로 고유한 세션 이름입니다.

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

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

*xuids*   \_In\_opt\_\
Type: uint64\_t\*

게임의 일부가 되기를 원하는 사용자를 나타내는 XBOX User ID(XUID) 배열입니다.

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

`xuids`에 지정된 배열의 요소 수입니다.

### Return value

Type: HRESULT

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

## Remarks

이 함수는 `xuids`에 지정된 XBOX 사용자 목록을 `sessionName`에 지정된 전역적으로 고유한 세션 이름으로 식별된 게임 세션에 참가시킵니다. 타이틀의 타사 매치메이킹 결과에서 전역적으로 고유한 세션 이름을 얻을 수 있으며, 게임에 참가해야 하는 모든 클라이언트에 대해 이 함수를 호출해야 합니다. \
이 함수의 결과는 이벤트 유형이 `XblMultiplayerEventType::JoinGameCompleted`로 설정된 멀티플레이어 이벤트로 전달됩니다. [XblMultiplayerManagerDoWork](https://docs.xbox.com/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md)를 호출하여 멀티플레이어 이벤트를 검색할 수 있습니다.  \
게임 세션에 참가하려고 할 때 서버가 가득 차면 서비스는 `HTTP_E_STATUS_BAD_REQUEST`를 반환합니다.  \
참가 후 [XblMultiplayerManagerGameSessionSetProperties](https://docs.xbox.com/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties.md) 또는 [XblMultiplayerManagerGameSessionSetSynchronizedProperties](https://docs.xbox.com/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties.md)를 호출하여 게임 세션의 속성을 설정하거나, [XblMultiplayerManagerGameSessionSetSynchronizedHost](https://docs.xbox.com/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md)를 호출하여 게임 세션의 호스트를 설정할 수 있습니다.

## Requirements

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

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

## See also

[multiplayer\_manager\_c](https://docs.xbox.com/ko/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)


## Related topics

- [XblMultiplayerManagerJoinGameFromLobby](https://docs.xbox.com/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.md)
- [XblMultiplayerManagerLeaveGame](https://docs.xbox.com/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerleavegame.md)
- [XblMultiplayerManagerJoinLobby](https://docs.xbox.com/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](https://docs.xbox.com/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)
- [Multiplayer Manager API 개요](https://docs.xbox.com/ko/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)