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

# PFAuthenticationLoginWithSteamIdRequest

> PFAuthenticationLoginWithSteamIdRequest 数据模型。如果这是用户首次使用 Steam ID 登录且 CreateAccount 设为 true，将创建一个新帐户。

PFAuthenticationLoginWithSteamIdRequest 数据模型。如果这是用户首次使用 Steam ID 登录且 CreateAccount 设为 true，将创建一个新的 PlayFab 帐户并链接到该 Steam 帐户。在这种情况下，该 PlayFab 帐户将没有关联的电子邮件或用户名。否则，如果没有 PlayFab 帐户链接到该 Steam 帐户，将返回相应的错误，以便游戏引导用户创建 PlayFab 帐户。未登录到 Steam 客户端应用的 Steam 用户仅会同步其 Steam 用户名，其他数据（例如货币和国家/地区）在客户端打开并登录之前不可用。

## 语法

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

### 成员

**`createAccount`**   bool

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

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

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

**`customTagsCount`**   uint32\_t

customTags 的数量

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

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

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

用户的唯一 Steam 标识符。

## 要求

**头文件：** PFAuthenticationTypes.h

## 另请参阅

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


## Related topics

- [PFAuthenticationServerLoginWithSteamIdAsync](/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithsteamidasync.md)
- [服务 C API 概览 - PFAuthenticationTypes.h](/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members.md)
- [PFAuthenticationLoginWithSteamRequest](/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithsteamrequest.md)
- [PFAuthenticationServerLoginWithSteamIdGetResult](/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithsteamidgetresult.md)
- [PFAuthenticationServerLoginWithSteamIdGetResultSize](/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithsteamidgetresultsize.md)