> ## 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::GetEntityIdsFromXboxLiveUserIds

> 將非同步作業排入佇列，以擷取 PlayFab 實體識別碼與已知 XBOX Live 使用者識別碼之間的對應清單。

將非同步作業排入佇列，以擷取 PlayFab 實體識別碼與已知 XBOX Live 使用者識別碼之間的對應清單。

## 語法

```cpp theme={null}
PartyError GetEntityIdsFromXboxLiveUserIds(  
    uint32_t xboxLiveUserIdCount,  
    const uint64_t* xboxLiveUserIds,  
    const PartyXblLocalChatUser* localChatUser,  
    void* asyncIdentifier  
)  
```

### 參數

**`xboxLiveUserIdCount`**   uint32\_t

`xboxLiveUserIds` 陣列中的 XBOX Live 使用者識別碼數目。

**`xboxLiveUserIds`**   uint64\_t\*\
*大小為 `xboxLiveUserIdCount` 的輸入陣列*

大小為 `xboxLiveUserIdCount` 的陣列，包含程式庫要查詢其 PlayFab 實體識別碼的 XBOX Live 使用者識別碼。

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

將用來與 PlayFab 通訊的本機聊天使用者。如有需要，本機聊天使用者會登入 PlayFab。

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

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

### 傳回值

PartyError

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

## 備註

只有在 XBOX Live 使用者已連結至 PlayFab 帳戶時，每個 XBOX Live 使用者識別碼才會對應至 PlayFab 實體識別碼。第一次呼叫 [PartyXblManager::LoginToPlayFab](/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_logintoplayfab) 時，會自動建立並連結 PlayFab 帳戶。PlayFab SDK 提供的 **LoginWithXbox** API 也可用來連結帳戶。<br /><br /> 如果與此呼叫完成相關聯的 [PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](/zh-TW/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange) 表示失敗，且結果為 [PartyXblStateChangeResult::PlayFabUserNotAuthorized](/zh-TW/services/playfab/multiplayer/networking/xblreference/enums/partyxblstatechangeresult)，則在成功呼叫 LoginToPlayFab() 之後，最多可以重試作業一次。<br /><br /> 如果與此呼叫完成相關聯的 [PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](/zh-TW/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange) 表示失敗，且結果為 [PartyXblStateChangeResult::PlayFabRateLimitExceeded](/zh-TW/services/playfab/multiplayer/networking/xblreference/enums/partyxblstatechangeresult)，則可以在短暫延遲後重試作業。

## 需求

**標頭：** PartyXboxLive.h

## 另請參閱

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


## Related topics

- [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)
- [PartyXblStateChangeType](/zh-TW/services/playfab/multiplayer/networking/xblreference/enums/partyxblstatechangetype.md)
- [PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](/zh-TW/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange.md)
- [PartyXblManager](/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/partyxblmanager.md)