> ## 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](/zh-TW/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\*\
*以 null 結尾*

找到之大廳的識別碼。

**`connectionString`**   const char\*\
*以 null 結尾*

找到之大廳的連接字串。

`connectionString` 可以為 null。在此情況下，需要邀請才能加入。

**`ownerEntity`**   const [PFEntityKey](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\*\
*可能為 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](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\*\
*大小為 `friendCount` 的陣列*

如果大廳搜尋是使用 `PFLobbySearchFriendsFilter` 執行的，則為找到之大廳中的朋友清單。

如果產生此搜尋結果的大廳搜尋不是使用 `PFLobbySearchFriendsFilter` 執行的，此清單一律為空白。 <br /><br /> 在某些多人遊戲社交網路中，朋友關係是單向的。一位使用者可以「追蹤」另一位使用者或成為其朋友，但反向不一定成立。只有在存在雙向朋友關係時，才會在此搜尋結果中傳回朋友。也就是說，查詢大廳的使用者和大廳中的使用者必須互為朋友。

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

找到之大廳目前的鎖定狀態。

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

- [PFLobbyFindLobbiesCompletedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyfindlobbiescompletedstatechange.md)
- [使用 Multiplayer SDK 將 Party 與 Lobby 整合](/zh-TW/services/playfab/multiplayer/networking/party-lobby-integration.md)
- [PlayFab Multiplayer C++ SDK 版本資訊](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [LobbySearchResult](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchResult/overview.md)
- [LobbySearchResult.SearchProperties](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchResult/SearchProperties.md)