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

# XtfCreateApplicationClient

> XtfCreateApplicationClient

# XtfCreateApplicationClient

为具有指定地址的开发主机初始化 [IXtfApplicationClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md) 接口的新实例。

## 语法

```cpp theme={null}
HRESULT XtfCreateApplicationClient(
         LPCWSTR pszAddress,
         REFIID riid,
         void **ppvObject
)  
```

### 参数

*pszAddress*\
类型：LPCWSTR

指向要用于新 [IXtfApplicationClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md) 的开发主机的工具 IP 地址的指针。

*riid*\
类型：REFIID

接收新创建的 [IXtfApplicationClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md) 的实例标识符的指针。

*ppvObject*\
类型：void\*\*

接收新创建的 [IXtfApplicationClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md) 引用的指针。

### 返回值

类型：HRESULT

如果成功则返回 `S_OK`；否则返回 HRESULT 错误代码。

## 备注

此函数创建 [IXtfApplicationClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md) 的新实例，并将其附加到 `pszAddress` 中指定的开发主机。然后你可以将新的 `IXtfApplicationClient` 实例用于该部署主机，以部署和卸载应用；启动、终止、约束、解除约束、暂停、恢复和查询应用的执行状态；以及获取和设置有关应用的信息。

有关可用工具和自动化 API（例如 XBOX Tools Framework (XTF)）的详细信息，请参阅[工具和自动化 API (NDA 主题)](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/debug/atoc-api-tools-dev-env)。

## 要求

**头文件：** xtfapplication.h

**库：** xtfapplication.lib

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

## 另请参阅

[IXtfApplicationClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)\
[XtfApplication](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)


## Related topics

- [XtfApplication（API 内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)
- [XtfCreateFileIOClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtffileio/methods/xtfcreatefileioclient-xtffileio-xbox-microsoft-m.md)
- [XtfCreateInputClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfinput/methods/xtfcreateinputclient-xtfinput-xbox-windows-m.md)
- [XtfCreateUserClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/methods/xtfcreateuserclient-xtfuser-xbox-windows-m.md)
- [IXtfApplicationClient 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)