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

# XtfCreateUserClient

> XtfCreateUserClient

# XtfCreateUserClient

使用指定的位址初始化 [IXtfUserClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md) 介面的新執行個體。

## 語法

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

### 參數

*pszAddress*\
類型：LPCWSTR

指向新 [IXtfUserClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md) 執行個體所要使用之開發主機工具 IP 位址的指標。

*riid*\
類型：REFIID

接收新建立之 [IXtfUserClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md) 執行個體之執行個體識別碼的指標。

*ppvObject*\
類型：void \*\*

接收新建立之 [IXtfUserClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md) 執行個體參考的指標。

### 傳回值

類型：HRESULT

作業的結果。

## 備註

此函式會建立 [IXtfUserClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md) 的新執行個體，並將其附加至 `pszAddress` 中指定的開發主機。接著，您可以使用新的 `IXtfUserClient` 執行個體來新增和刪除使用者、登入和登出使用者，以及配對使用者與控制器。您也可以處理派對。

## 需求

**標頭：** xtfuser.h

**程式庫：** xtfuser.lib

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

## 另請參閱

[IXtfUserClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)\
[XtfUser](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/xtfuser-xbox-windows-n.md)


## Related topics

- [XTF_USER_DATA](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md)
- [XtfUser (API 內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/xtfuser-xbox-windows-n.md)
- [XtfCreateFileIOClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/methods/xtfcreatefileioclient-xtffileio-xbox-microsoft-m.md)
- [XtfCreateApplicationClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapplication/methods/xtfcreateapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [XtfCreateInputClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfinput/methods/xtfcreateinputclient-xtfinput-xbox-windows-m.md)