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

# PFLobbySearchConfiguration

> PFMultiplayerFindLobbies 的設定結構：為大廳搜尋指定朋友篩選條件、篩選字串、排序字串和用戶端搜尋結果計數。

用於指定應如何執行 [PFMultiplayerFindLobbies](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) 作業的設定結構。

## 語法

```cpp theme={null}
struct PFLobbySearchConfiguration {  
    const PFLobbySearchFriendsFilter* friendsFilter;  
    const char* filterString;  
    const char* sortString;  
    const uint32_t* clientSearchResultCount;  
}  
```

### 成員

**`friendsFilter`**   const [PFLobbySearchFriendsFilter](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchfriendsfilter)\*\
*可能為 nullptr*

篩選條件，提供時會將大廳搜尋作業限制為只搜尋由該玩家各種朋友清單中的成員所擁有的大廳。

如果省略，搜尋作業將搜尋所有可用的大廳。<br /><br /> 只有在使用 title\_player\_account 實體呼叫 [PFMultiplayerFindLobbies](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) 時才能指定此值。

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

用於篩選搜尋結果中傳回哪些大廳的查詢字串。

此字串以類似 OData 的篩選語法格式化。<br /><br /> 只支援下列運算子："and" (邏輯且)、"eq" (等於)、"ne" (不等於)、"ge" (大於或等於)、"gt" (大於)、"le" (小於或等於) 和 "lt" (小於)。   <br /><br /> 每個 OData 邏輯運算式的左側應為搜尋屬性索引鍵 (例如 string\_key1、number\_key3 等) 或其中一個預先定義的搜尋索引鍵 (`PFLobbyMemberCountSearchKey`、`PFLobbyAmMemberSearchKey` 或 `PFLobbyMembershipLockSearchKey`)   <br /><br /> 每個 OData 邏輯運算式的左側應為搜尋屬性索引鍵。   <br /><br /> 此字串不得超過 500 個字元。   <br /><br /> 範例："lobby/membershipLock eq 'Unlocked' and string\_key1 eq 'CaptureTheFlag' and number\_key10 gt 50 and lobby/memberCount lt 5"

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

用於排序搜尋結果中所傳回之大廳的查詢字串。

此字串以類似 OData 的 order-by 語法格式化：以逗號分隔的搜尋屬性索引鍵清單，並可選擇性地指定以遞增或遞減順序排序。<br /><br /> 若要指定遞增順序，請在相關聯的搜尋屬性索引鍵之後使用 "asc" 運算子。若要指定遞減順序，請在相關聯的搜尋屬性索引鍵之後使用 "desc" 運算子。   <br /><br /> 此外，也支援一個特殊的排序名稱 distance，可依與某個數值的最近距離排序。例如，"distance\{number\_key10=5} asc" 會排序結果，讓 "number\_key10" 搜尋屬性較接近值 "5" 的大廳在搜尋結果中較早傳回。   <br /><br /> 此字串不得超過 100 個字元。   <br /><br /> 範例："string\_key1 asc,lobby/memberCount desc"

**`clientSearchResultCount`**   const uint32\_t\*\
*可能為 nullptr*

選用值，由 title\_player\_account 實體指定時，會限制完成回應中提供的結果數目。

只有在使用 title\_player\_account 實體呼叫 [PFMultiplayerFindLobbies](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) 時才能指定此值。<br /><br /> 此值不得高於 `PFLobbyClientRequestedSearchResultCountUpperLimit`。   <br /><br /> 未指定時，搜尋結果數目的限制由服務定義，但不會大於 `PFLobbyClientRequestedSearchResultCountUpperLimit`。

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

- [PFLobby 搜尋索引鍵](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/constants/pflobbysearchkeys.md)
- [PFMultiplayerFindLobbies](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies.md)
- [PlayFab Multiplayer C++ SDK 版本資訊](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [LobbySearchConfiguration](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchConfiguration/LobbySearchConfiguration.md)
- [LobbySearchConfiguration 類別](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchConfiguration/overview.md)