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

# PFAuthenticationLoginWithCustomIDRequest

> PFAuthenticationLoginWithCustomIDRequest 数据模型。强烈建议开发人员确保客户生成的 ID 极不可能与其他客户正在使用的 ID 相同。

PFAuthenticationLoginWithCustomIDRequest 数据模型。强烈建议开发人员确保客户生成的 ID 极不可能与其他客户正在使用的 ID 相同。如果这是用户首次使用自定义 ID 登录且 CreateAccount 设为 true，将创建一个新的 PlayFab 帐户并链接到该自定义 ID。在这种情况下，该 PlayFab 帐户将没有关联的电子邮件或用户名。否则，如果没有 PlayFab 帐户链接到该自定义 ID，将返回相应的错误，以便游戏引导用户创建 PlayFab 帐户。

## 语法

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

### 成员

**`createAccount`**   bool

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

**`customId`**   const char\*\
*is null-terminated*

由游戏为用户生成的自定义唯一标识符。

**`customTags`**   PFStringDictionaryEntry const\*\
*may be nullptr*

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

**`customTagsCount`**   uint32\_t

customTags 的数量

**`infoRequestParameters`**   PFGetPlayerCombinedInfoRequestParams const\*\
*may be nullptr*

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

**`playerSecret`**   const char\*\
*is null-terminated*

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

## 要求

**头文件：** PFAuthenticationTypes.h

## 另请参阅

[PFAuthenticationTypes 成员](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members.md)


## Related topics

- [PFAuthenticationLoginWithCustomIDAsync](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithcustomidasync.md)
- [PFAuthenticationReLoginWithCustomIDAsync](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationreloginwithcustomidasync.md)
- [PFAuthenticationLoginWithServerCustomIdRequest](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithservercustomidrequest.md)
- [PFAuthenticationServerLoginWithCustomIDRequest](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationserverloginwithcustomidrequest.md)
- [PFAuthenticationLoginWithPSNRequest](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithpsnrequest.md)