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

# XTF_USER_DATA

> XTF_USER_DATA

# XTF\_USER\_DATA

描述模拟用户。

<a id="syntaxSection" />

## 语法

```cpp theme={null}
typedef struct XTF_USER_DATA {
    UINT32 userId;
    WCHAR szEmailAddress[256];
    WCHAR szGamertag[32];
    BOOL bSignedIn;
    XTF_USER_XUID xuid;
    BOOL bAutoSignIn;
} XTF_USER_DATA, *PXTF_USER_DATA;  
```

<a id="ID4EG" />

<a id="membersSection" />

### 成员

**userId**\
类型：UINT32

用户的唯一标识符

**szEmailAddress**\
类型：WCHAR

用于登录用户的电子邮件地址。

**szGamertag**\
类型：WCHAR

用户的玩家代号。

**bSignedIn**\
类型：BOOL

如果为 true，则用户已登录。

**xuid**\
类型：XTF\_USER\_XUID

用户的 XBOX 用户 ID。

**bAutoSignIn**\
类型：BOOL

如果为 true，则用户已设置为自动登录。

<a id="remarksSection" />

## 备注

此结构在 [IXtfUserClient::ListUsers](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m) 方法中使用。

此结构的成员提供了在调用其他 [IXtfUserClient](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t) 方法时可以使用的值。

若要创建实现 `IXtfUserClient` 接口的对象，请调用 [XtfCreateUserClient](/reference/tools/xtf/xtfuser/methods/xtfcreateuserclient-xtfuser-xbox-windows-m)。

<a id="requirements" />

<a id="requirementsSection" />

## 要求

**头文件：** xtfuser.h

**库：** xtfuser.lib

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

<a id="seealsoSection" />

## 另请参阅

[XtfUser](/reference/tools/xtf/xtfuser/xtfuser-xbox-windows-n)


## Related topics

- [XTF_USER_DATA_V2](/zh-CN/reference/tools/xtf/xtfuser/structures/xtf_user_data_v2.md)
- [IXtfUserClient::ListUsers](/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SignoutUser](/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::PairControllerWithUser Method](/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::PairControllerWithUserId Method](/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)