> ## 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 实体 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\*](/services/playfab/multiplayer/networking/xblreference/classes/PartyXblLocalChatUser/partyxbllocalchatuser)

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

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

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

### Return value

PartyError

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

## Remarks

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

## Requirements

**Header:** PartyXboxLive.h

## See also

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


## Related topics

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