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

# PFLobbyGetSearchProperty

> Referencia de PFLobbyGetSearchProperty para leer el valor de una propiedad de búsqueda por clave en un lobby de PlayFab mediante las API de lobby del SDK de C++ de PlayFab Multiplayer.

Obtiene el valor de la propiedad de búsqueda a partir de su clave.

## Sintaxis

```cpp theme={null}
HRESULT PFLobbyGetSearchProperty(  
    PFLobbyHandle lobby,  
    const char* key,  
    const char** value  
)  
```

### Parámetros

**`lobby`**   PFLobbyHandle

El identificador del lobby.

**`key`**   char\*\
*termina en null*

La clave de la propiedad.

**`value`**   char\*\*\
*salida asignada por la biblioteca, puede devolver nullptr*

El valor de salida asociado a la clave. Un valor null de salida significa que la propiedad no estaba presente.

### Valor devuelto

Tipo: HRESULT

`S_OK` si la llamada se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Comentarios

Las propiedades de búsqueda son visibles para los no miembros del lobby como metadatos que se pueden usar para filtrar y ordenar los resultados de búsqueda de lobbies. <br /><br /> Si este objeto de lobby todavía está en proceso de crearse, unirse o reclamarse de forma asincrónica mediante una llamada a [PFMultiplayerCreateAndJoinLobby()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby), [PFMultiplayerCreateAndClaimServerLobby](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandclaimserverlobby), [PFMultiplayerClaimServerLobby()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerclaimserverlobby) o [PFMultiplayerJoinLobby()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby), este método no devolverá ninguna propiedad.

## Requisitos

**Encabezado:** PFLobby.h

## Consulte también

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


## Related topics

- [Información general de la API de C/C++ de PFMultiplayer - PFLobby.h](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [PFLobbyGetSearchPropertyKeys](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchpropertykeys.md)
- [Lobby.GetSearchProperties](/es/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetSearchProperties.md)
- [LobbySearchResult.SearchProperties](/es/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchResult/SearchProperties.md)
- [Lobby.LobbyMaxSearchPropertyCount](/es/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyConstants/LobbyMaxSearchPropertyCount.md)