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

# XTF_USER_DATA

> XTF_USER_DATA

# XTF\_USER\_DATA

描述模拟用户。

## 语法

```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;  
```

### 成员

**userId**\
类型：UINT32

用户的唯一标识符

**szEmailAddress**\
类型：WCHAR

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

**szGamertag**\
类型：WCHAR

用户的玩家代号。

**bSignedIn**\
类型：BOOL

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

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

用户的 XBOX 用户 ID。

**bAutoSignIn**\
类型：BOOL

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

## 备注

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

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

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

## 要求

**头文件：** xtfuser.h

**库：** xtfuser.lib

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

## 另请参阅

[XtfUser](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/xtfuser-xbox-windows-n.md)


## Related topics

- [XTF_USER_DATA_V2](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/structures/xtf_user_data_v2.md)
- [ListUsers](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [XtfUser（API 内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/xtfuser-xbox-windows-n.md)
- [SignoutUser](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [PairControllerWithUser](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)