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

> Queues an asynchronous operation to retrieve a list of mappings between PlayFab Entity Ids and known XBOX Live User Ids.

Queues an asynchronous operation to retrieve a list of mappings between PlayFab Entity Ids and known XBOX Live User Ids.

## Syntax

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

### Parameters

**`xboxLiveUserIdCount`**   uint32\_t

The number of XBOX Live User Ids in the `xboxLiveUserIds` array.

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

An array of size `xboxLiveUserIdCount` containing the XBOX Live User Ids for which the library will query the PlayFab Entity Id.

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

Local chat user that will be used to communicate with PlayFab. The local chat user will be logged in to PlayFab if needed.

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

An optional, app-defined, pointer-sized context value that can be used to associate the completion state change with this call.

### Return value

PartyError

`c_partyErrorSuccess` if the operation started or an error code otherwise. The human-readable form of the error code can be retrieved via [GetErrorMessage()](/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_geterrormessage).

## Remarks

Each XBOX Live User Id will only map to a PlayFab Entity Id if this XBOX Live User has already been linked to a PlayFab account. A PlayFab account is automatically created and linked when calling [PartyXblManager::LoginToPlayFab](/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_logintoplayfab) for the first time. The **LoginWithXbox** API provided by the PlayFab SDK can also be used to link an account. <br /><br /> If the [PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange) associated with the completion of this call indicates a failure with a result of [PartyXblStateChangeResult::PlayFabUserNotAuthorized](/services/playfab/multiplayer/networking/xblreference/enums/partyxblstatechangeresult), the operation can be retried no more than one time after successfully calling LoginToPlayFab().   <br /><br /> If the [PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange) associated with the completion of this call indicates a failure with a result of [PartyXblStateChangeResult::PlayFabRateLimitExceeded](/services/playfab/multiplayer/networking/xblreference/enums/partyxblstatechangeresult), the operation can be retried after a brief delay.

## 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 Helper Release Notes](/services/playfab/multiplayer/networking/party-xboxlive-relnotes.md)
- [XBOX Live helper library for PlayFab Party](/services/playfab/multiplayer/networking/party-xbox-live-guide.md)
- [PartyXblStateChangeType](/services/playfab/multiplayer/networking/xblreference/enums/partyxblstatechangetype.md)
- [PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange](/services/playfab/multiplayer/networking/xblreference/structs/partyxblgetentityidsfromxboxliveuseridscompletedstatechange.md)
- [PartyXblManager](/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/partyxblmanager.md)
