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

> Struct de configuration pour PFMultiplayerFindLobbies : spécifie le filtre d'amis, la chaîne de filtre, la chaîne de tri et le nombre de résultats de recherche côté client pour les recherches de lobbies.

Structure de configuration utilisée pour spécifier la façon dont une opération [PFMultiplayerFindLobbies](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) doit être effectuée.

## Syntaxe

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

### Membres

**`friendsFilter`**   const [PFLobbySearchFriendsFilter](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchfriendsfilter)\*\
*peut être nullptr*

Filtre qui, lorsqu'il est fourni, limite l'opération de recherche de lobbies aux seuls lobbies détenus par les membres des différentes listes d'amis du joueur.

S'il est omis, l'opération de recherche porte sur tous les lobbies disponibles. <br /><br /> Cette valeur ne peut être spécifiée que lorsque [PFMultiplayerFindLobbies](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) est appelé avec une entité title\_player\_account.

**`filterString`**   const char\*\
*se termine par un caractère null*

Chaîne de requête utilisée pour filtrer les lobbies retournés dans les résultats de recherche.

Cette chaîne est mise en forme selon une syntaxe de filtrage de type OData. <br /><br /> Seuls les opérateurs suivants sont pris en charge : "and" (et logique), "eq" (égal), "ne" (différent), "ge" (supérieur ou égal), "gt" (supérieur), "le" (inférieur ou égal) et "lt" (inférieur).   <br /><br /> La partie gauche de chaque expression logique OData doit être soit une clé de propriété de recherche (p. ex., string\_key1, number\_key3, etc.), soit l'une des clés de recherche prédéfinies (`PFLobbyMemberCountSearchKey`, `PFLobbyAmMemberSearchKey` ou `PFLobbyMembershipLockSearchKey`)   <br /><br /> La partie gauche de chaque expression logique OData doit être une clé de propriété de recherche.   <br /><br /> Cette chaîne ne peut pas dépasser 500 caractères.   <br /><br /> Exemple : "lobby/membershipLock eq 'Unlocked' and string\_key1 eq 'CaptureTheFlag' and number\_key10 gt 50 and lobby/memberCount lt 5"

**`sortString`**   const char\*\
*se termine par un caractère null*

Chaîne de requête utilisée pour trier les lobbies retournés dans les résultats de recherche.

Cette chaîne est mise en forme selon une syntaxe de tri (order-by) de type OData : une liste de clés de propriétés de recherche séparées par des virgules, avec un spécificateur facultatif permettant de trier par ordre croissant ou décroissant. <br /><br /> Pour spécifier l'ordre croissant, utilisez l'opérateur "asc" après la clé de propriété de recherche associée. Pour spécifier l'ordre décroissant, utilisez l'opérateur "desc" après la clé de propriété de recherche associée.   <br /><br /> En outre, un mot-clé de tri spécial, distance, est pris en charge pour permettre un tri selon la distance la plus proche d'une valeur numérique. Par exemple, "distance\{number\_key10=5} asc" trie les résultats de sorte que les lobbies dont la propriété de recherche "number\_key10" est la plus proche de la valeur "5" apparaissent en premier dans les résultats de recherche.   <br /><br /> Cette chaîne ne peut pas dépasser 100 caractères.   <br /><br /> Exemple : "string\_key1 asc,lobby/memberCount desc"

**`clientSearchResultCount`**   const uint32\_t\*\
*peut être nullptr*

Valeur facultative qui, lorsqu'elle est spécifiée par des entités title\_player\_account, limite le nombre de résultats fournis dans la réponse d'achèvement.

Cette valeur ne peut être spécifiée que lorsque [PFMultiplayerFindLobbies](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) est appelé avec une entité title\_player\_account. <br /><br /> Cette valeur ne peut pas être supérieure à `PFLobbyClientRequestedSearchResultCountUpperLimit`.   <br /><br /> Lorsqu'elle n'est pas spécifiée, la limite du nombre de résultats de recherche est définie par le service, mais ne dépasse pas `PFLobbyClientRequestedSearchResultCountUpperLimit`.

## Configuration requise

**En-tête :** PFLobby.h

## Voir aussi

[Membres de PFLobby](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [Clés de recherche PFLobby](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/constants/pflobbysearchkeys.md)
- [PFMultiplayerFindLobbies](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies.md)
- [Notes de version du SDK C++ PlayFab Multiplayer](/fr-CA/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [LobbySearchConfiguration](/fr-CA/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchConfiguration/LobbySearchConfiguration.md)
- [Classe LobbySearchConfiguration](/fr-CA/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchConfiguration/overview.md)