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

# XtfStartTitleOSByVersion

> XtfStartTitleOSByVersion

# XtfStartTitleOSByVersion

지정한 [FourPartVersion](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md)과 일치하는 Game OS를 콘솔 캐시에서 시작하거나 다시 시작합니다.

## 구문

```cpp theme={null}
HRESULT XtfStartTitleOSByVersion(
         PCWSTR address,
         FourPartVersion version
)  
```

### 매개 변수

*address*\
형식: PCWSTR

\[in] 콘솔의 주소입니다.

*version*\
형식: [FourPartVersion](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md)

\[in] 시작할 Game OS의 4부 버전 정보입니다.

### 반환값

형식: HRESULT

성공하면 `S_OK`를 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

## 설명

이 함수를 사용하여 지정한 `FourPartVersion`과 일치하는 Game OS를 콘솔 캐시에서 시작하거나 다시 시작합니다. [XtfGetCachedTitleOSVersions](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md) 함수를 사용하여 콘솔에 캐시된 각 Game OS의 `FourPartVersion`을 가져오거나, [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md) 함수를 사용하여 현재 실행 중인 타이틀의 Game OS에 대한 `FourPartVersion`을 가져올 수 있습니다.

시작하거나 다시 시작하려는 Game OS의 [FourPartVersion](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md)이 없는 경우에는 대신 [XtfStartTitleOS](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md) 함수를 사용하여 Game OS의 GameOs.vxd 파일의 전체 경로와 파일 이름과 같은 다른 식별자를 지정해 Game OS를 시작하거나 다시 시작하세요. 또한 [XtfStartTitleOSByGameConfig](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m.md) 함수를 사용하여 지정된 MicrosoftGame.config 파일 내용에 지정된 Game OS를 시작하거나 다시 시작할 수도 있습니다.

필요한 경우 [XtfCacheTitleOS](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md) 함수를 호출하여 콘솔 캐시에 Game OS를 추가할 수 있습니다. 프로비저닝된 Game OS 파일 관리에 대한 자세한 내용은 [Application Management (xbapp.exe) (NDA topic)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xbapp.md)과 [Provision (xbprovision.exe) (NDA topic)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xbprovision.md)을 참조하세요.

## 요구 사항

**헤더:** xtfapi.h

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

**지원 플랫폼:** Windows(XBOX 콘솔 도구용)

## 참고 항목

[Run from PC Deployment (NDA topic)](https://docs.xbox.com/ko/home/setup-install/concepts/deployment.md)\
[XTF Transport Errors (NDA topic)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[Additional Xtf APIs](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfStartTitleOS](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersionsCallback](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)
- [FourPartVersion](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md)
- [추가 Xtf API (API 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfStartTitleOSByGameConfig](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m.md)