> ## 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 实体 ID 与已知 XBOX Live 用户 ID 之间的映射列表。

将异步操作加入队列，以检索 PlayFab 实体 ID 与已知 XBOX Live 用户 ID 之间的映射列表。

## Syntax

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

### Parameters

**`xboxLiveUserIdCount`**   uint32\_t

`xboxLiveUserIds` 数组中 XBOX Live 用户 ID 的数量。

**`xboxLiveUserIds`**   uint64\_t\*\
*input array of size `xboxLiveUserIdCount`*

大小为 `xboxLiveUserIdCount` 的数组，包含库将用于查询 PlayFab 实体 ID 的 XBOX Live 用户 ID。

**`localChatUser`**   [PartyXblLocalChatUser\*](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblLocalChatUser/partyxbllocalchatuser.md)

将用于与 PlayFab 通信的本地聊天用户。如有需要，将使该本地聊天用户登录到 PlayFab。

**`asyncIdentifier`**   void\*\
*optional*

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

### Return value

PartyError

如果操作已启动则返回 `c_partyErrorSuccess`，否则返回错误代码。错误代码的可读形式可通过 [GetErrorMessage()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_geterrormessage.md) 获取。

## Remarks

只有当 XBOX Live 用户已与 PlayFab 账户关联时，每个 XBOX Live 用户 ID 才会映射到 PlayFab 实体 ID。首次调用 [PartyXblManager::LoginToPlayFab](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_logintoplayfab.md) 时会自动创建并关联 PlayFab 账户。也可以使用 PlayFab SDK 提供的 **LoginWithXbox** API 来关联账户。\
\
 如果与此调用完成相关联的 [PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange.md) 指示失败，结果为 [PartyXblStateChangeResult::PlayFabUserNotAuthorized](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/enums/partyxblstatechangeresult.md)，则在成功调用 LoginToPlayFab() 后最多可重试一次。  \
\
 如果与此调用完成相关联的 [PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange.md) 指示失败，结果为 [PartyXblStateChangeResult::PlayFabRateLimitExceeded](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/enums/partyxblstatechangeresult.md)，则可以在短暂延迟后重试该操作。

## Requirements

**Header:** PartyXboxLive.h

## See also

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


## Related topics

- [PlayFab Party Xbox Live 帮助程序发行说明](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/party-xboxlive-relnotes.md)
- [适用于 PlayFab Party 的 XBOX Live 辅助库](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/party-xbox-live-guide.md)
- [PartyXblStateChangeType](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/enums/partyxblstatechangetype.md)
- [PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange.md)
- [PartyXblManager](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/partyxblmanager.md)