> ## 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](/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](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchfriendsfilter)\*\
*nullptr の可能性があります*

指定した場合、そのプレイヤーの各種フレンド リストのメンバーが所有するロビーのみにロビー検索操作を制限するフィルターです。

省略した場合、検索操作はすべての利用可能なロビーを検索します。<br /><br /> この値は、[PFMultiplayerFindLobbies](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) が title\_player\_account エンティティで呼び出された場合にのみ指定できます。

**`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 エンティティによって指定された場合、完了応答で提供される結果の数を制限するオプションの値です。

この値は、[PFMultiplayerFindLobbies](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) が title\_player\_account エンティティで呼び出された場合にのみ指定できます。<br /><br /> この値は `PFLobbyClientRequestedSearchResultCountUpperLimit` を超えることはできません。<br /><br /> 指定しない場合、検索結果数の制限はサービスで定義されますが、`PFLobbyClientRequestedSearchResultCountUpperLimit` を超えることはありません。

## 要件

**ヘッダー:** PFLobby.h

## 関連項目

[PFLobby のメンバー](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PFLobby 検索キー](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/constants/pflobbysearchkeys.md)
- [PFMultiplayerFindLobbies](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies.md)
- [PFMultiplayer C/C++ API 概要 - PFLobby.h](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [PlayFab Multiplayer C++ SDK リリース ノート](/ja-jp/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [LobbySearchConfiguration](/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchConfiguration/LobbySearchConfiguration.md)