> ## 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 结构体：PFMultiplayerFindLobbies 调用成功完成后返回的大厅搜索结果集合中的一项。

在 [PFMultiplayerFindLobbies](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) 操作成功完成后收到的大厅搜索结果集合中的一项。

## 语法

```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;  
}  
```

### 成员

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

找到的大厅的 ID。

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

找到的大厅的连接字符串。

`connectionString` 可以为 null。在这种情况下，需要邀请才能加入。

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

大厅的当前所有者。

如果大厅当前没有所有者，`ownerEntity` 可以为 null。

**`maxMemberCount`**   uint32\_t

此大厅中可容纳的最大成员数。

**`currentMemberCount`**   uint32\_t

此大厅中当前的成员数。

**`searchPropertyCount`**   uint32\_t

与此大厅关联的搜索属性数量。

**`searchPropertyKeys`**   const char\* const\*\
*大小为 `searchPropertyCount` 的数组*

与此大厅关联的搜索属性的键。

**`searchPropertyValues`**   const char\* const\*\
*大小为 `searchPropertyCount` 的数组*

与此大厅关联的搜索属性的值。

**`friendCount`**   uint32\_t

如果大厅搜索使用 `PFLobbySearchFriendsFilter` 执行，则为找到的大厅中的好友数量。

如果生成此搜索结果的大厅搜索并非使用 `PFLobbySearchFriendsFilter` 执行，则此值将始终为 0。<br /><br /> 在某些多人游戏社交网络中，好友关系是单向的。一个用户可能"关注"另一个用户或成为其好友，但反向关系不一定成立。仅当存在双向好友关系时，好友才会在此搜索结果中返回。也就是说，查询大厅的用户和大厅中的用户必须彼此互为好友。

**`friends`**   const [PFEntityKey](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\*\
*大小为 `friendCount` 的数组*

如果大厅搜索使用 `PFLobbySearchFriendsFilter` 执行，则为找到的大厅中的好友列表。

如果生成此搜索结果的大厅搜索并非使用 `PFLobbySearchFriendsFilter` 执行，则此列表将始终为空。<br /><br /> 在某些多人游戏社交网络中，好友关系是单向的。一个用户可能"关注"另一个用户或成为其好友，但反向关系不一定成立。仅当存在双向好友关系时，好友才会在此搜索结果中返回。也就是说，查询大厅的用户和大厅中的用户必须彼此互为好友。

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

找到的大厅的当前锁定状态。

## 要求

**头文件：** PFLobby.h

## 另请参阅

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


## Related topics

- [PFLobbyFindLobbiesCompletedStateChange](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyfindlobbiescompletedstatechange.md)
- [使用多人 SDK 将 Party 与 Lobby 集成](/zh-CN/services/playfab/multiplayer/networking/party-lobby-integration.md)
- [PlayFab Multiplayer C++ SDK 发行说明](/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFMultiplayer C/C++ API 概览 - PFLobby.h](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [LobbySearchResult](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchResult/overview.md)