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

> Estructura de configuración para PFMultiplayerFindLobbies: especifica el filtro de amigos, la cadena de filtro, la cadena de ordenación y el número de resultados de búsqueda del cliente para las búsquedas de lobbies.

La estructura de configuración que se usa para especificar cómo se debe realizar una operación [PFMultiplayerFindLobbies](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies).

## Sintaxis

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

### Miembros

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

Un filtro que, cuando se proporciona, restringirá la operación de búsqueda de lobbies solo a aquellos que sean propiedad de los miembros de las distintas listas de amigos de ese jugador.

Si se omite, la operación de búsqueda buscará en todos los lobbies disponibles. <br /><br /> Este valor solo se puede especificar cuando se llama a [PFMultiplayerFindLobbies](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) con una entidad title\_player\_account.

**`filterString`**   const char\*\
*termina en null*

La cadena de consulta que se usa para filtrar qué lobbies se devuelven en los resultados de búsqueda.

Esta cadena tiene un formato de sintaxis de filtrado similar a OData. <br /><br /> Solo se admiten los operadores siguientes: "and" (y lógico), "eq" (igual), "ne" (no igual), "ge" (mayor o igual), "gt" (mayor que), "le" (menor o igual) y "lt" (menor que).   <br /><br /> El lado izquierdo de cada expresión lógica de OData debe ser una clave de propiedad de búsqueda (por ejemplo, string\_key1, number\_key3, etc.) o una de las claves de búsqueda predefinidas (`PFLobbyMemberCountSearchKey`, `PFLobbyAmMemberSearchKey` o `PFLobbyMembershipLockSearchKey`)   <br /><br /> El lado izquierdo de cada expresión lógica de OData debe ser una clave de propiedad de búsqueda.   <br /><br /> Esta cadena no puede superar los 500 caracteres.   <br /><br /> Ejemplo: "lobby/membershipLock eq 'Unlocked' and string\_key1 eq 'CaptureTheFlag' and number\_key10 gt 50 and lobby/memberCount lt 5"

**`sortString`**   const char\*\
*termina en null*

La cadena de consulta que se usa para ordenar los lobbies devueltos en los resultados de búsqueda.

Esta cadena tiene un formato de sintaxis order-by similar a OData: una lista separada por comas de claves de propiedad de búsqueda con un especificador opcional para ordenar de forma ascendente o descendente. <br /><br /> Para especificar el orden ascendente, use el operador "asc" después de la clave de propiedad de búsqueda asociada. Para especificar el orden descendente, use el operador "desc" después de la clave de propiedad de búsqueda asociada.   <br /><br /> Además, se admite un moniker de ordenación especial, distance, para permitir la ordenación por distancia más cercana a algún valor numérico. Por ejemplo, "distance\{number\_key10=5} asc" ordenará los resultados de forma que los lobbies cuya propiedad de búsqueda "number\_key10" esté más cerca del valor "5" aparezcan antes en los resultados de búsqueda.   <br /><br /> Esta cadena no puede superar los 100 caracteres.   <br /><br /> Ejemplo: "string\_key1 asc,lobby/memberCount desc"

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

Un valor opcional que, cuando lo especifican entidades title\_player\_account, limitará el número de resultados proporcionados en la respuesta de finalización.

Este valor solo se puede especificar cuando se llama a [PFMultiplayerFindLobbies](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) con una entidad title\_player\_account. <br /><br /> Este valor no puede ser superior a `PFLobbyClientRequestedSearchResultCountUpperLimit`.   <br /><br /> Cuando no se especifica, el límite del número de resultados de búsqueda lo define el servicio, pero no será mayor que `PFLobbyClientRequestedSearchResultCountUpperLimit`.

## Requisitos

**Encabezado:** PFLobby.h

## Consulte también

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


## Related topics

- [Claves de búsqueda de PFLobby](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/constants/pflobbysearchkeys.md)
- [PFMultiplayerFindLobbies](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies.md)
- [Notas de la versión del SDK de C++ de PlayFab Multiplayer](/es/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Información general de la API de C/C++ de PFMultiplayer - PFLobby.h](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [LobbySearchConfiguration](/es/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchConfiguration/LobbySearchConfiguration.md)