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

# XLaunchNewGame

> XLaunchNewGame

# XLaunchNewGame

현재 게임을 종료하고, 할당된 리소스를 해제한 다음, 새 게임을 실행합니다.

## 구문

```cpp theme={null}
void XLaunchNewGame(  
         const char* exePath,  
         const char* args,  
         XUserHandle defaultUser  
)  
```

### 매개 변수

*exePath*   \_In\_z\_\
형식: char\*

실행할 새 게임의 경로 및 파일 이름입니다. 이 경로는 현재 디렉터리에 대한 상대 경로이거나 절대 경로일 수 있습니다. 호출 실행 파일의 경로를 알아야 하는 게임은 모듈 핸들에 nullptr을 지정하여 [GetModuleFileNameA](https://learn.microsoft.com/windows/win32/api/libloaderapi/nf-libloaderapi-getmodulefilenamea)를 호출할 수 있습니다.

*args*   \_In\_opt\_z\_\
형식: char\*

새 게임을 실행하는 데 사용되는 해당 게임 관련 인수입니다.

*defaultUser*   \_In\_opt\_\
형식: XUserHandle

새 게임을 실행하는 사용자의 핸들입니다. 값이 지정되지 않으면 현재 사용자가 지정됩니다.

### 반환 값

형식: void

이 함수는 게임을 다시 시작할 수 없는 경우에도 값을 반환하거나 예외를 발생시키지 않습니다.

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한</Note>
내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.

이 함수는 게임을 다시 시작하고, 게임의 현재 프로세스를 종료한 다음, 새 프로세스를 사용하여 게임을 다시 시작합니다. 게임이 실행 중인 가상 머신을 다시 시작하지 않고 게임이 다시 시작됩니다. 게임을 다시 시작할 때 다른 기본 사용자와 게임별 인수를 지정할 수 있습니다. 다른 기본 사용자를 지정하는 방법에 대한 자세한 내용은 [사용자 ID 및 XUser](/build/core-features/common/user/player-identity-xuser)를 참조하세요.

현재 프로세스는 함수가 새 게임을 시작하는 동안 오류가 발생하더라도 항상 종료됩니다. 예를 들어 *exePath*, *args* 또는 *defaultUser*에 지정된 값이 유효하지 않은 경우에도 함수는 값을 반환하거나 예외를 발생시키지 않습니다.

<Note>이 함수를 호출하면 이전에 마운트된 모든 DLC는 마운트 해제됩니다. **XLaunchNewGame**의</Note>
대상을 호스팅하는 DLC는 예외입니다. **G:** 드라이브는 계속해서 새로 실행된 EXE가 아닌 기본 패키지의 루트를 가리킵니다.

<Note>**XLaunchNewGame**이 호출된 후 새로 실행된 게임이 일시 중단 핸들러를</Note>
설정하기 전에 게임이 일시 중단되면 게임이 종료됩니다. 이는 매우 좁은 시간 창이며 실제로는 발생할 가능성이 매우 낮습니다.

<Note>[XMemTransferMemory(NDA 항목)](/reference/system/xmem/functions/xmemtransfermemory)를 사용하여 시스템으로 전송된 메모리는 유지됩니다.</Note>

## 요구 사항

**헤더:** XGame.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 개념 문서

* [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [GaaS(Games-as-a-Service) 지원](/build/core-features/common/packaging/supporting-games-as-a-service)

## 함께 보기

[XGame](/reference/system/xgame/xgame_members)\
[사용자 ID 및 XUser](/build/core-features/common/user/player-identity-xuser)\
[XLaunchUri](/reference/system/xlauncher/functions/xlaunchuri)


## Related topics

- [XLaunchRestartOnCrash](/ko/reference/system/xgame/functions/xlaunchrestartoncrash.md)
- [게임의 기본 사용자 변경](/ko/build/core-features/common/user/users-changing-default-user.md)
- [Games-as-a-Service(GaaS) 지원](/ko/build/core-features/common/packaging/supporting-games-as-a-service.md)
- [XGame](/ko/reference/system/xgame/xgame_members.md)
- [사용자 및 입력 장치](/ko/build/core-features/common/user/users-input-devices.md)