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

# PFLobbySearchResult

> PFLobbySearchResult struct: an entry in the collection of lobby search results returned upon successful completion of a PFMultiplayerFindLobbies call.

An entry in the collection of lobby search results received upon successful completion of a [PFMultiplayerFindLobbies](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) operation.

## Syntax

```cpp theme={null}
struct PFLobbySearchResult {  
    const char* lobbyId;  
    const char* connectionString;  
    const PFEntityKey* ownerEntity;  
    uint32_t maxMemberCount;  
    uint32_t currentMemberCount;  
    uint32_t searchPropertyCount;  
    const char* const* searchPropertyKeys;  
    const char* const* searchPropertyValues;  
    uint32_t friendCount;  
    const PFEntityKey* friends;  
    PFLobbyMembershipLock membershipLock;  
}  
```

### Members

**`lobbyId`**   const char\*\
*is null-terminated*

The ID of the found lobby.

**`connectionString`**   const char\*\
*is null-terminated*

The connection string of the found lobby.

`connectionString` can be null. In this case, an invite is required to join.

**`ownerEntity`**   const [PFEntityKey](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\*\
*may be nullptr*

The current owner of the lobby.

`ownerEntity` may be null if the lobby doesn't currently have an owner.

**`maxMemberCount`**   uint32\_t

The maximum number of members that can be present in this lobby.

**`currentMemberCount`**   uint32\_t

The current number of members that are present in this lobby.

**`searchPropertyCount`**   uint32\_t

The number of search properties associated with this lobby.

**`searchPropertyKeys`**   const char\* const\*\
*array of size `searchPropertyCount`*

The keys of the search properties associated with this lobby.

**`searchPropertyValues`**   const char\* const\*\
*array of size `searchPropertyCount`*

The values of the search properties associated with this lobby.

**`friendCount`**   uint32\_t

The number of friends in the found lobby, if the lobby search was performed with a `PFLobbySearchFriendsFilter`.

If the lobby search which generated this search result was not performed with a `PFLobbySearchFriendsFilter`, this value will always be 0. <br /><br /> In some multiplayer social networks, friendship is a unidirectional relationship. One user may "follow" another or be their friend, but the same is not necessarily true in the reverse direction. Friends will only be returned in this search result when a bidirectional friendship exists. That is, the user querying for the lobby and the user in the lobby must both be friends with each other.

**`friends`**   const [PFEntityKey](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\*\
*array of size `friendCount`*

The list of friends in the found lobby, if the lobby search was performed with a `PFLobbySearchFriendsFilter`.

If the lobby search which generated this search result was not performed with a `PFLobbySearchFriendsFilter`, this list will always be empty. <br /><br /> In some multiplayer social networks, friendship is a unidirectional relationship. One user may "follow" another or be their friend, but the same is not necessarily true in the reverse direction. Friends will only be returned in this search result when a bidirectional friendship exists. That is, the user querying for the lobby and the user in the lobby must both be friends with each other.

**`membershipLock`**   [PFLobbyMembershipLock](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymembershiplock)

The current lock state of the found lobby.

## Requirements

**Header:** PFLobby.h

## See also

[PFLobby members](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PFLobbyFindLobbiesCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyfindlobbiescompletedstatechange.md)
- [PlayFab Multiplayer C++ SDK Release Notes](/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Integrate Party with Lobby using Multiplayer SDK](/services/playfab/multiplayer/networking/party-lobby-integration.md)
- [PFMultiplayer C/C++ API overview - PFLobby.h](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [LobbySearchResult](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchResult/overview.md)