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

# XtfCreateApplicationClient

> XtfCreateApplicationClient

# XtfCreateApplicationClient

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

<a id="syntaxSection" />

## 语法

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

<a id="parametersSection" />

### 参数

*pszAddress*\
类型：LPCWSTR

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

*riid*\
类型：REFIID

接收新创建的 [IXtfApplicationClient](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t) 的实例标识符的指针。

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

接收新创建的 [IXtfApplicationClient](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t) 引用的指针。

<a id="retvalSection" />

### 返回值

类型：HRESULT

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

<a id="remarksSection" />

## 备注

此函数创建 [IXtfApplicationClient](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t) 的新实例，并将其附加到 `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)。

<a id="requirementsSection" />

## 要求

**头文件：** xtfapplication.h

**库：** xtfapplication.lib

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

<a id="seealsoSection" />

## 另请参阅

[IXtfApplicationClient](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t)\
[XtfApplication](/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfApplicationClient::Constrain](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Launch](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/launch-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Resume](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/resume-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Snap](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/snap-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Suspend](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/suspend-ixtfapplicationclient-xtfapplication-xbox-windows.md)