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

# XtfCacheTitleOS

> XtfCacheTitleOS

# XtfCacheTitleOS

Game OS를 OS 캐시에 추가합니다.

## Syntax

```cpp theme={null}
HRESULT XtfCacheTitleOS(
         PCWSTR address,
         PCWSTR osIdentifier
)  
```

### Parameters

*address*\
Type: PCWSTR

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

*osIdentifier*\
Type: PCWSTR

\[in] 추가할 Game OS의 식별자입니다. 이 식별자는 다음 중 하나일 수 있습니다.

* 추가할 Game OS 버전의 4자리 버전 번호를 포함하는 MicrosoftGame.config 파일의 전체 경로 및 파일 이름
* GameOs.xvd 파일의 전체 경로 및 파일 이름
* MicrosoftGame.config 또는 GameOS.vxd 파일이 포함된 디렉터리의 전체 경로
* 추가할 Game OS의 4자리 버전 번호

유효한 식별자의 예:

* D:\MyGame
* \MyDevPC\share\MyGame\MicrosoftGame.config
* xd:\Titles\MyGamePFN\GameOs.xvd
* 10.0.18236.1002

### Return value

Type: HRESULT

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

## Remarks

지정된 Game OS를 콘솔의 캐시에 추가하여 프로비저닝된 Game OS 파일을 관리하려면 이 함수를 사용합니다. [XtfGetCachedTitleOSVersions](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md) 함수를 사용하여 콘솔에 캐시된 각 Game OS의 버전 정보를 가져올 수 있습니다. 또한 [XtfRemoveTitleOSFromCache](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m.md) 또는 [XtfRemoveTitleOSFromCacheByVersion](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcachebyversion-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)을 참조하세요.

## Requirements

**Header:** xtfapi.h

**Library:** XtfApi.lib

**Supported platforms:** Windows(XBOX 콘솔 도구용)

## See also

[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

- [XtfRemoveTitleOSFromCache](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersions](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md)
- [XtfRemoveTitleOSFromCacheByVersion](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcachebyversion-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOS](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)
- [추가 Xtf API (API 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/atoc-xtfapi.md)