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

# PFAuthenticationLoginWithXUserRequest

> PFAuthenticationLoginWithXUserRequest 数据模型。如果这是用户首次使用 XBOX Live 帐户登录且 CreateAccount 设为 true。

PFAuthenticationLoginWithXUserRequest 数据模型。如果这是用户首次使用 XBOX Live 帐户登录且 CreateAccount 设为 true，将创建一个新的 PlayFab 帐户并链接到该 XBOX Live 帐户。在这种情况下，该 PlayFab 帐户将没有关联的电子邮件或用户名。否则，如果没有 PlayFab 帐户链接到该 XBOX Live 帐户，将返回相应的错误，以便游戏引导用户创建 PlayFab 帐户。用于 PFAuthenticationLoginWithXUserAsync 的请求对象。

## 语法

```cpp theme={null}
typedef struct PFAuthenticationLoginWithXUserRequest {  
    bool createAccount;  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFGetPlayerCombinedInfoRequestParams const* infoRequestParameters;  
    const char* playerSecret;  
    XUserHandle user;  
} PFAuthenticationLoginWithXUserRequest;  
```

### 成员

**`createAccount`**   bool

如果当前没有 PlayFab 帐户链接到此 ID，则自动创建一个。

**`customTags`**   PFStringDictionaryEntry const\*<br />*may be nullptr*

（可选）与请求关联的可选自定义标记（例如生成号、外部跟踪标识符等）。

**`customTagsCount`**   uint32\_t

customTags 的数量

**`infoRequestParameters`**   PFGetPlayerCombinedInfoRequestParams const\*<br />*may be nullptr*

（可选）标志，指示要为该用户返回哪些信息。

**`playerSecret`**   const char\*<br />*is null-terminated*

（可选）用于验证 API 请求签名的玩家密钥（仅限企业版）。

**`user`**   XUserHandle

从 XUserAddAsync 或 XUserAddByIdWithUiAsync 返回的 XUserHandle。

## 要求

**头文件：** PFAuthenticationTypes.h

## 另请参阅

[PFAuthenticationTypes 成员](/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members)


## Related topics

- [PFAuthenticationLoginWithXUserAsync](/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithxuserasync.md)
- [PFAuthenticationReLoginWithXUserAsync](/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationreloginwithxuserasync.md)
- [事件管道教程](/zh-CN/services/playfab/sdks/c/event-pipeline/eventpipeline-tutorial.md)
- [服务 C API 概览 - PFAuthenticationTypes.h](/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members.md)
- [PFAuthenticationLoginWithSteamRequest](/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithsteamrequest.md)