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

# PFAuthenticationLoginWithCustomIDRequest

> PFAuthenticationLoginWithCustomIDRequest 資料模型。強烈建議開發人員確保客戶極不可能產生已被其他客戶使用的識別碼。如果這是使用者第一次使用自訂識別碼登入，且 CreateAccount 設定為 true，系統將會建立新的 PlayFab 帳戶，並將其連結至自訂識別碼。在此情況下，不會有任何電子郵件或使用者名稱與該 PlayFab 帳戶相關聯。否則，如果沒有任何 PlayFab 帳戶連結至自訂識別碼，將會傳回指出此情況的錯誤，讓遊戲可以引導使用者建立 PlayFab 帳戶。

PFAuthenticationLoginWithCustomIDRequest 資料模型。強烈建議開發人員確保客戶極不可能產生已被其他客戶使用的識別碼。如果這是使用者第一次使用自訂識別碼登入，且 CreateAccount 設定為 true，系統將會建立新的 PlayFab 帳戶，並將其連結至自訂識別碼。在此情況下，不會有任何電子郵件或使用者名稱與該 PlayFab 帳戶相關聯。否則，如果沒有任何 PlayFab 帳戶連結至自訂識別碼，將會傳回指出此情況的錯誤，讓遊戲可以引導使用者建立 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 帳戶連結至此識別碼，則自動建立一個。

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

（選擇性）指定要為使用者傳回哪些資訊的旗標。

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

（選擇性）用來驗證 API 要求簽章的玩家密碼。

## 需求

**標頭：** PFAuthenticationTypes.h

## 另請參閱

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


## Related topics

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