> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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\*](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblLocalChatUser/partyxbllocalchatuser.md)

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

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

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

### 傳回值

PartyError

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

## 備註

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

## 需求

**標頭：** PartyXboxLive.h

## 另請參閱

[PartyXblManager](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/partyxblmanager.md)\
[PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange.md)


## Related topics

- [PlayFab Party Xbox Live 協助程式版本資訊](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/party-xboxlive-relnotes.md)
- [PartyXblStateChangeType](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/enums/partyxblstatechangetype.md)
- [PlayFab Party 的 XBOX Live 協助程式庫](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/party-xbox-live-guide.md)
- [PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange.md)
- [PartyXblManager](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/partyxblmanager.md)