> ## 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 使用者識別碼。

**bAutoSignIn**\
類型：BOOL

如果為 true，表示使用者已設定為自動登入。

## 備註

此結構用於 [IXtfUserClient::ListUsers](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m.md) 方法。

此結構的成員提供您在呼叫其他 [IXtfUserClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md) 方法時可使用的值。

若要建立實作 `IXtfUserClient` 介面的物件，請呼叫 [XtfCreateUserClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfuser/methods/xtfcreateuserclient-xtfuser-xbox-windows-m.md)。

## 需求

**標頭：** xtfuser.h

**程式庫：** xtfuser.lib

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

## 另請參閱

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


## Related topics

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