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

# PFAuthenticationServerLoginWithCustomIDRequest

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

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

## 语法

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

### 成员

**`createAccount`**   bool

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

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

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

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

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

**`customTagsCount`**   uint32\_t

customTags 的数量

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

（可选）用于指定要为用户返回哪些信息的标志。

## 要求

**头文件：** PFAuthenticationTypes.h

## 另请参阅

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


## Related topics

- [PFAuthenticationServerLoginWithCustomIDAsync](/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithcustomidasync.md)
- [PFAuthenticationLoginWithServerCustomIdRequest](/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithservercustomidrequest.md)
- [PFAuthenticationServerLoginWithServerCustomIdAsync](/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithservercustomidasync.md)
- [PFAuthenticationServerLoginWithPSNRequest](/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationserverloginwithpsnrequest.md)
- [PFAuthenticationServerLoginWithXboxRequest](/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationserverloginwithxboxrequest.md)