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

# XtfGetSavedConsoleAddress

> XtfGetSavedConsoleAddress

# XtfGetSavedConsoleAddress

获取 XBOX Tools Framework (XTF) 应用的默认主机的 Tools IP 地址。

<a id="syntaxSection" />

## 语法

```cpp theme={null}
HRESULT XtfGetSavedConsoleAddress(
         BSTR* savedAddress
)  
```

<a id="parametersSection" />

### 参数

*savedAddress*<br />类型：BSTR\*

\[in] 指向 XTF 应用默认主机地址的指针。

<a id="retvalSection" />

### 返回值

类型：HRESULT

成功时返回 `S_OK`；否则返回一个 HRESULT 错误代码。

<a id="remarksSection" />

## 备注

此函数从通过 [IXtfConsoleManager::SetDefaultConsole](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/setdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m) 方法标识为 XBOX Tools Framework (XTF) 应用默认主机的开发主机上获取 Tools IP 地址。`XtfGetSavedConsoleAddress` 是一个实用函数，用于获取由主机管理器的 [IXtfConsoleManager::GetDefaultConsole 方法](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m) 返回的 [XTFCONSOLEDATA](/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t) 结构中 `bstrAddress` 成员的值。有关主机管理器的更多信息，请参阅 [IXtfConsoleManager 接口](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t)。

<a id="requirementsSection" />

## 要求

**头文件：** xtfutils.h

**库：** XtfApi.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

[Run from PC Deployment (NDA 主题)](/home/setup-install/concepts/deployment)<br />[XTF 传输错误 (NDA 主题)](/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[其他 Xtf API](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfGetDefaultAddress](/zh-CN/reference/tools/xtf/xtfconsolemanager/methods/xtfgetdefaultaddress-xtfconsolemanager-xbox-windows-m.md)
- [XtfGetConsoleFieldValue](/zh-CN/reference/tools/xtf/xtfapi/functions/xtfgetconsolefieldvalue-xbox-microsoft-m.md)
- [XtfCreateConsoleManager](/zh-CN/reference/tools/xtf/xtfconsolemanager/methods/xtfcreateconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [XtfGetConsoleInfoList](/zh-CN/reference/tools/xtf/xtfconsolecontrol/functions/xtfgetconsoleinfolist-xtfconsolecontrol-xbox-microsoft-m.md)
- [XtfGetAvailableSpaceForAppInstallation](/zh-CN/reference/tools/xtf/xtfconsolecontrol/functions/xtfgetavailablespaceforappinstallation-xtfconsolecontrol-xbox-microsoft-m.md)