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

# XtfCreateUserClient

> XtfCreateUserClient

# XtfCreateUserClient

使用指定地址初始化 [IXtfUserClient](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t) 接口的新实例。

<a id="syntaxSection" />

## 语法

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

<a id="ID4EG" />

<a id="parametersSection" />

### 参数

*pszAddress*\
类型：LPCWSTR

指向要用于新 [IXtfUserClient](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t) 实例的开发主机的工具 IP 地址的指针。

*riid*\
类型：REFIID

接收新创建的 [IXtfUserClient](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t) 实例的实例标识符的指针。

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

接收对新创建的 [IXtfUserClient](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t) 实例的引用的指针。

<a id="ID4EN" />

<a id="retvalSection" />

### 返回值

类型：HRESULT

操作的结果。

<a id="remarksSection" />

## 备注

此函数创建 [IXtfUserClient](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t) 的新实例，并将其附加到 `pszAddress` 中指定的开发主机。然后，可以使用新的 `IXtfUserClient` 实例来添加和删除用户、登录和注销用户，以及将用户和控制器进行配对。你还可以使用它来处理组队。

<a id="requirements" />

<a id="requirementsSection" />

## 要求

**头文件：** xtfuser.h

**库：** xtfuser.lib

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

<a id="seealsoSection" />

## 另请参阅

[IXtfUserClient](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t)\
[XtfUser](/reference/tools/xtf/xtfuser/xtfuser-xbox-windows-n)


## Related topics

- [XTF_USER_DATA](/zh-CN/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md)
- [XtfCreateApplicationClient](/zh-CN/reference/tools/xtf/xtfapplication/methods/xtfcreateapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [XtfCreateInputClient](/zh-CN/reference/tools/xtf/xtfinput/methods/xtfcreateinputclient-xtfinput-xbox-windows-m.md)
- [XtfCreateFileIOClient](/zh-CN/reference/tools/xtf/xtffileio/methods/xtfcreatefileioclient-xtffileio-xbox-microsoft-m.md)
- [XtfCreateDebugMonitorClient](/zh-CN/reference/tools/xtf/xtfdebugmonitor/methods/xtfcreatedebugmonitorclient-xtfdebugmonitor-xbox-microsoft-m.md)