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

# PFAuthenticationLoginWithXboxIdRequest

> PFAuthenticationLoginWithXboxIdRequest 資料模型。如果這是使用者第一次使用 XBOX ID 登入，且 CreateAccount 設定為 true，系統將會建立新的 PlayFab 帳戶。

PFAuthenticationLoginWithXboxIdRequest 資料模型。如果這是使用者第一次使用 XBOX ID 登入，且 CreateAccount 設定為 true，系統將會建立新的 PlayFab 帳戶，並將其連結至 XBOX Live 帳戶。在此情況下，不會有任何電子郵件或使用者名稱與該 PlayFab 帳戶相關聯。否則，如果沒有任何 PlayFab 帳戶連結至 XBOX Live 帳戶，將會傳回指出此情況的錯誤，讓遊戲可以引導使用者建立 PlayFab 帳戶。

## 語法

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

### 成員

**`createAccount`**   bool

如果目前沒有 PlayFab 帳戶連結至此識別碼，則自動建立一個。

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

（選擇性）與要求相關聯的選擇性自訂標籤（例如組建編號、外部追蹤識別碼等）。

**`customTagsCount`**   uint32\_t

customTags 的計數

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

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

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

XBOX Live 沙箱的識別碼。

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

使用者的唯一 XBOX 識別碼。

## 需求

**標頭：** PFAuthenticationTypes.h

## 另請參閱

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


## Related topics

- [PFAuthenticationServerLoginWithXboxIdAsync](/zh-TW/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithxboxidasync.md)
- [服務 C API 概觀 - PFAuthenticationTypes.h](/zh-TW/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members.md)
- [PFAuthenticationLoginWithSteamIdRequest](/zh-TW/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithsteamidrequest.md)
- [PFAuthenticationLoginWithOpenIdConnectRequest](/zh-TW/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithopenidconnectrequest.md)
- [PFAuthenticationLoginWithServerCustomIdRequest](/zh-TW/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithservercustomidrequest.md)