> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFMultiplayerFindLobbies

> Referência de PFMultiplayerFindLobbies para pesquisar lobbies do PlayFab em nome de um usuário local usando cadeias de caracteres de filtro e classificação no SDK C++ do PlayFab Multiplayer.

Pesquisa lobbies em nome do usuário local.

## Sintaxe

```cpp theme={null}
HRESULT PFMultiplayerFindLobbies(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* searchingEntity,  
    const PFLobbySearchConfiguration* searchConfiguration,  
    void* asyncContext  
)  
```

### Parâmetros

**`handle`**   PFMultiplayerHandle

O identificador da instância da API PFMultiplayer.

**`searchingEntity`**   [PFEntityKey\*](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk.md)

A entidade do PlayFab que está realizando a pesquisa.

**`searchConfiguration`**   [PFLobbySearchConfiguration\*](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchconfiguration.md)

A configuração usada para filtrar e classificar os lobbies pesquisados.

**`asyncContext`**   void\*\
*opcional*

Um valor de contexto opcional, definido pelo aplicativo e do tamanho de um ponteiro, que pode ser usado para associar a alteração de estado de conclusão a esta chamada.

### Valor retornado

Tipo: HRESULT

`S_OK` se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md).

## Comentários

Esta é uma operação assíncrona. Após a conclusão bem-sucedida, o título receberá uma [PFLobbyFindLobbiesCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyfindlobbiescompletedstatechange.md) com o campo [PFLobbyFindLobbiesCompletedStateChange::result](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyfindlobbiescompletedstatechange.md) definido como `S_OK`. Após uma conclusão com falha, o título receberá uma [PFLobbyFindLobbiesCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyfindlobbiescompletedstatechange.md) com o campo [PFLobbyFindLobbiesCompletedStateChange::result](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyfindlobbiescompletedstatechange.md) definido como uma falha.

## Requisitos

**Cabeçalho:** PFLobby.h

## Confira também

[Membros do PFLobby](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)


## Related topics

- [Integrar o Party ao Lobby usando o Multiplayer SDK](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/party-lobby-integration.md)
- [PFLobbySearchConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchconfiguration.md)
- [PFLobbySearchResult](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchresult.md)
- [Notas de versão do SDK C++ do PlayFab Multiplayer](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Usar o lobby e o matchmaking juntos](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)