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

# XtfStartTitleOSByGameConfig

> XtfStartTitleOSByGameConfig

# XtfStartTitleOSByGameConfig

根據以字串形式儲存在記憶體中的 MicrosoftGame.config 檔案內容，啟動或重新啟動 Game OS。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
HRESULT XtfStartTitleOSByGameConfig(
         PCWSTR address,
         UINT32 flags,
         PCWSTR gameconfigContents
)  
```

<a id="parametersSection" />

### 參數

*address*\
類型：PCWSTR

\[in] 主機的 IP 位址。

*flags*\
類型：UINT32

\[in] 目前未使用，但保留供未來的行為變更使用。

*gameconfigContents*\
類型：PCWSTR

\[in] MicrosoftGame.config 檔案的內容。

<a id="retvalSection" />

### 傳回值

類型：HRESULT

如果成功，則傳回 `S_OK`；否則傳回錯誤碼。

<a id="remarksSection" />

## 備註

使用此函式可根據以字串形式儲存在記憶體中的 MicrosoftGame.config 檔案內容，啟動或重新啟動 Game OS。如果未指定 `address` 或 `gameconfigContents` 的值，就會發生錯誤。

如需 MicrosoftGame.config 檔案內容的詳細資訊，請參閱 [MicrosoftGame.config 概觀](/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Overview)。

<a id="requirements" />

## 需求

**標頭：** xtfapi.h

**程式庫：** XtfApi.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

<a id="seealsoSection" />

## 另請參閱

[XTF 傳輸錯誤 (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors)\
[其他 Xtf API](/zh-TW/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfStartTitleOS](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOSByVersion](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md)
- [XtfCacheTitleOS](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md)
- [XtfRemoveTitleOSFromCache](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersionsCallback](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)