> ## 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 configuração de PFMultiplayerFindLobbies: especifica o filtro de amigos, a cadeia de caracteres de filtro, a cadeia de caracteres de classificação e a contagem de resultados de pesquisa do cliente para pesquisas de lobbies.

A estrutura de configuração usada para especificar como uma operação [PFMultiplayerFindLobbies](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) deve ser executada.

## Sintaxe

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

### Membros

**`friendsFilter`**   const [PFLobbySearchFriendsFilter](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchfriendsfilter)\*\
*pode ser nullptr*

Um filtro que, quando fornecido, restringirá a operação de pesquisa de lobbies apenas aos lobbies pertencentes aos membros das várias listas de amigos desse jogador.

Se omitido, a operação de pesquisa pesquisará todos os lobbies disponíveis. <br /><br /> Esse valor só pode ser especificado quando [PFMultiplayerFindLobbies](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) for chamado com uma entidade title\_player\_account.

**`filterString`**   const char\*\
*terminada em nulo*

A cadeia de caracteres de consulta usada para filtrar quais lobbies são retornados nos resultados da pesquisa.

Essa cadeia de caracteres é formatada em uma sintaxe de filtragem semelhante ao OData. <br /><br /> Somente os seguintes operadores têm suporte: "and" (e lógico), "eq" (igual), "ne" (diferente), "ge" (maior ou igual), "gt" (maior que), "le" (menor ou igual) e "lt" (menor que).   <br /><br /> O lado esquerdo de cada expressão lógica OData deve ser uma chave de propriedade de pesquisa (por exemplo, string\_key1, number\_key3 etc.) ou uma das chaves de pesquisa predefinidas (`PFLobbyMemberCountSearchKey`, `PFLobbyAmMemberSearchKey` ou `PFLobbyMembershipLockSearchKey`)   <br /><br /> O lado esquerdo de cada expressão lógica OData deve ser uma chave de propriedade de pesquisa.   <br /><br /> Essa cadeia de caracteres não pode exceder 500 caracteres.   <br /><br /> Exemplo: "lobby/membershipLock eq 'Unlocked' and string\_key1 eq 'CaptureTheFlag' and number\_key10 gt 50 and lobby/memberCount lt 5"

**`sortString`**   const char\*\
*terminada em nulo*

A cadeia de caracteres de consulta usada para classificar os lobbies retornados nos resultados da pesquisa.

Essa cadeia de caracteres é formatada em uma sintaxe order-by semelhante ao OData: uma lista separada por vírgulas de chaves de propriedades de pesquisa com um especificador opcional para classificar em ordem crescente ou decrescente. <br /><br /> Para especificar a ordem crescente, use o operador "asc" após a chave de propriedade de pesquisa associada. Para especificar a ordem decrescente, use o operador "desc" após a chave de propriedade de pesquisa associada.   <br /><br /> Além disso, há suporte a um moniker de classificação especial, distance, para permitir a classificação pela menor distância em relação a algum valor numérico. Por exemplo, "distance\{number\_key10=5} asc" classificará os resultados de modo que os lobbies cuja propriedade de pesquisa "number\_key10" esteja mais próxima do valor "5" apareçam primeiro nos resultados da pesquisa.   <br /><br /> Essa cadeia de caracteres não pode exceder 100 caracteres.   <br /><br /> Exemplo: "string\_key1 asc,lobby/memberCount desc"

**`clientSearchResultCount`**   const uint32\_t\*\
*pode ser nullptr*

Um valor opcional que, quando especificado por entidades title\_player\_account, limitará o número de resultados fornecidos na resposta de conclusão.

Esse valor só pode ser especificado quando [PFMultiplayerFindLobbies](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) for chamado com uma entidade title\_player\_account. <br /><br /> Esse valor não pode ser maior que `PFLobbyClientRequestedSearchResultCountUpperLimit`.   <br /><br /> Quando não especificado, o limite do número de resultados de pesquisa é definido pelo serviço, mas não será maior que `PFLobbyClientRequestedSearchResultCountUpperLimit`.

## Requisitos

**Cabeçalho:** PFLobby.h

## Confira também

[Membros do PFLobby](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [Chaves de pesquisa do PFLobby](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/constants/pflobbysearchkeys.md)
- [PFMultiplayerFindLobbies](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies.md)
- [Notas de versão do SDK C++ do PlayFab Multiplayer](/pt-BR/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [LobbySearchConfiguration](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchConfiguration/LobbySearchConfiguration.md)
- [LobbySearchConfiguration class](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchConfiguration/overview.md)