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

# PFAuthenticationLoginWithXboxRequest

> PFAuthenticationLoginWithXboxRequest 데이터 모델. 사용자가 XBOX Live 계정으로 처음 로그인하는 경우이고 CreateAccount가 true로 설정된 경우.

PFAuthenticationLoginWithXboxRequest 데이터 모델. 사용자가 XBOX Live 계정으로 처음 로그인하는 경우이고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 XBOX Live 계정에 연결됩니다. 이 경우 이메일이나 사용자 이름은 PlayFab 계정과 연결되지 않습니다. 그렇지 않으면 해당 XBOX Live 계정에 연결된 PlayFab 계정이 없는 경우 이를 나타내는 오류가 반환되어, 타이틀이 사용자가 PlayFab 계정을 만들도록 안내할 수 있게 됩니다.

## 구문

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

### 멤버

**`createAccount`**   bool

현재 이 ID에 연결된 계정이 없는 경우 자동으로 PlayFab 계정을 생성합니다.

**`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 요청 서명을 확인하는 데 사용되는 플레이어 비밀입니다(엔터프라이즈 전용).

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

XBOX Live SDK/XDK 메서드 GetTokenAndSignatureAsync("POST", "[https://playfabapi.com/](https://playfabapi.com/)", "")에서 제공한 토큰입니다.

## 요구 사항

**헤더:** PFAuthenticationTypes.h

## 참고 항목

[PFAuthenticationTypes 멤버](/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members)


## Related topics

- [PFAuthenticationLoginWithXboxAsync](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationloginwithxboxasync.md)
- [PFAuthenticationReLoginWithXboxAsync](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationreloginwithxboxasync.md)
- [Services C API 개요 - PFAuthenticationTypes.h](/ko/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members.md)
- [PFAuthenticationServerLoginWithXboxRequest](/ko/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationserverloginwithxboxrequest.md)
- [PFAuthenticationLoginWithXboxIdRequest](/ko/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithxboxidrequest.md)