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

> Référence de PFLobbyGetSearchProperty pour lire par clé la valeur d'une propriété consultable sur un lobby PlayFab à l'aide des API de lobby du SDK C++ PlayFab Multiplayer.

Obtient la valeur d'une propriété de recherche à partir de sa clé.

## Syntaxe

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

### Paramètres

**`lobby`**   PFLobbyHandle

Handle du lobby.

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

Clé de la propriété.

**`value`**   char\*\*\
*sortie allouée par la bibliothèque, peut renvoyer nullptr*

Valeur en sortie associée à la clé. Une valeur null en sortie signifie que la propriété n'était pas présente.

### Valeur renvoyée

Type : HRESULT

`S_OK` si l'appel a réussi, ou un code d'erreur dans le cas contraire. La forme lisible du code d'erreur peut être récupérée via [PFMultiplayerGetErrorMessage()](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Remarques

Les propriétés de recherche sont visibles par les non-membres du lobby en tant que métadonnées, qui peuvent être utilisées pour filtrer et trier les résultats de recherche de lobbies. <br /><br /> Si cet objet lobby est toujours en cours de création, de jonction ou de revendication asynchrone via un appel à [PFMultiplayerCreateAndJoinLobby()](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby), [PFMultiplayerCreateAndClaimServerLobby](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandclaimserverlobby), [PFMultiplayerClaimServerLobby()](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerclaimserverlobby) ou [PFMultiplayerJoinLobby()](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby), cette méthode ne renvoie aucune propriété.

## Configuration requise

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

## Voir aussi

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


## Related topics

- [PFLobbyGetSearchPropertyKeys](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchpropertykeys.md)
- [Lobby.GetSearchProperties](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetSearchProperties.md)
- [LobbySearchResult.SearchProperties](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchResult/SearchProperties.md)
- [Lobby.LobbyMaxSearchPropertyCount](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyConstants/LobbyMaxSearchPropertyCount.md)
- [LobbyCreateConfiguration.SearchProperties](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyCreateConfiguration/SearchProperties.md)