> ## 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 使用。

使用 XBOX Live 權杖讓使用者登入 PlayFab，以非同步方式傳回實體識別碼和實體權杖，之後可用於需要已驗證 PlayFab 使用者的 PlayFab API 呼叫，或用來建立 PartyLocalUser。呼叫此方法與使用 PlayFab SDK 提供的 LoginWithXbox 方法沒有差異。

## 語法

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

### 參數

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

將用於登入作業的本機聊天使用者物件。

**`asyncIdentifier`**   void\*\
*選用*

選用的應用程式定義指標大小內容值，可用來將完成狀態變更與此呼叫建立關聯。

### 傳回值

PartyError

如果讓本機聊天使用者登入 PlayFab 的作業已啟動，則為 `c_partyErrorSuccess`；否則為錯誤碼。可透過 [GetErrorMessage()](/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_geterrormessage) 擷取錯誤碼的人類可讀形式。

## 備註

如果這是 XBOX Live 身分識別第一次登入 PlayFab，將會建立新的 PlayFab 帳戶，並將其連結至 XBOX Live 身分識別。<br /><br /> 當權杖接近到期時間，或因應用程式長時間處於休眠狀態而導致權杖已過期時，應呼叫此方法取得新的權杖。建議在先前提供之權杖的有效期限過一半時取得新的權杖。

## 需求

**標頭：** PartyXboxLive.h

## 另請參閱

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


## Related topics

- [PartyXblManager::GetEntityIdsFromXboxLiveUserIds](/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getentityidsfromxboxliveuserids.md)
- [PlayFab Party XBOX Live 協助程式版本資訊](/zh-TW/services/playfab/multiplayer/networking/party-xboxlive-relnotes.md)
- [PlayFab Party 的 XBOX Live 協助程式庫](/zh-TW/services/playfab/multiplayer/networking/party-xbox-live-guide.md)
- [PartyXblXboxUserIdToPlayFabEntityIdMapping](/zh-TW/services/playfab/multiplayer/networking/xblreference/structs/partyxblxboxuseridtoplayfabentityidmapping.md)
- [PartyXblStateChangeType](/zh-TW/services/playfab/multiplayer/networking/xblreference/enums/partyxblstatechangetype.md)