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

# PartyXblManager::LoginToPlayFab

> 使用 XBOX Live 令牌将用户登录到 PlayFab,并异步返回用于 PlayFab API 调用或 PartyLocalUser 创建的 Entity ID 和 Token。

使用 XBOX Live 令牌将用户登录到 PlayFab,并异步返回 Entity ID 和 Entity Token,后续可用于需要经过身份验证的 PlayFab 用户的 PlayFab API 调用或用于创建 PartyLocalUser。调用此方法与使用 PlayFab SDK 提供的 LoginWithXbox 方法之间没有区别。

## 语法

```cpp theme={null}
PartyError LoginToPlayFab(  
    const PartyXblLocalChatUser* localChatUser,  
    void* asyncIdentifier  
)  
```

### 参数

**`localChatUser`**   [PartyXblLocalChatUser\*](/services/playfab/multiplayer/networking/xblreference/classes/PartyXblLocalChatUser/partyxbllocalchatuser)

将用于登录操作的本地聊天用户对象。

**`asyncIdentifier`**   void\*\
*可选*

一个可选的应用定义的指针大小的上下文值,可用于将完成状态更改与此调用相关联。

### 返回值

PartyError

若使用 PlayFab 登录本地聊天用户的操作已启动则返回 `c_partyErrorSuccess`,否则返回错误代码。可通过 [GetErrorMessage()](/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_geterrormessage) 检索该错误代码的可读形式。

## 备注

如果这是该 XBOX Live 标识首次登录到 PlayFab,将创建一个新的 PlayFab 帐户并将其链接到该 XBOX Live 标识。<br /><br /> 当令牌接近过期时间,或者因应用程序长时间处于休眠状态而使令牌过期时,应通过调用此方法获取新令牌。建议在先前提供的令牌达到其有效期的一半时获取新令牌。

## 要求

**头文件:** PartyXboxLive.h

## 另请参阅

[PartyXblManager](/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/partyxblmanager)\
[PartyXblLoginToPlayFabCompletedStateChange](/services/playfab/multiplayer/networking/xblreference/structs/partyxbllogintoplayfabcompletedstatechange)


## Related topics

- [PartyXblManager::GetEntityIdsFromXboxLiveUserIds](/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getentityidsfromxboxliveuserids.md)
- [PlayFab Party XBOX Live 辅助库发行说明](/zh-CN/services/playfab/multiplayer/networking/party-xboxlive-relnotes.md)
- [适用于 PlayFab Party 的 XBOX Live 辅助库](/zh-CN/services/playfab/multiplayer/networking/party-xbox-live-guide.md)
- [PartyXblXboxUserIdToPlayFabEntityIdMapping](/zh-CN/services/playfab/multiplayer/networking/xblreference/structs/partyxblxboxuseridtoplayfabentityidmapping.md)
- [PartyXblLoginToPlayFabCompletedStateChange](/zh-CN/services/playfab/multiplayer/networking/xblreference/structs/partyxbllogintoplayfabcompletedstatechange.md)