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

> PlayFab Multiplayer C++ SDK에서 필터 및 정렬 문자열을 사용하여 로컬 사용자를 대신해 PlayFab 로비를 검색하기 위한 PFMultiplayerFindLobbies 참조입니다.

로컬 사용자를 대신하여 로비를 검색합니다.

## 구문

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

### 매개 변수

**`handle`**   PFMultiplayerHandle

PFMultiplayer API 인스턴스의 핸들입니다.

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

검색을 수행하는 PlayFab 엔터티입니다.

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

검색된 로비를 필터링하고 정렬하는 데 사용되는 구성입니다.

**`asyncContext`**   void\*\
*선택 사항*

이 호출과 완료 상태 변경을 연결하는 데 사용할 수 있는 선택적인 앱 정의 포인터 크기의 컨텍스트 값입니다.

### 반환 값

형식: HRESULT

호출이 성공한 경우 `S_OK`이고, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형태는 [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md)를 통해 검색할 수 있습니다.

## 설명

이 작업은 비동기 작업입니다. 성공적으로 완료되면 타이틀에는 [PFLobbyFindLobbiesCompletedStateChange::result](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyfindlobbiescompletedstatechange.md) 필드가 `S_OK`로 설정된 [PFLobbyFindLobbiesCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyfindlobbiescompletedstatechange.md)가 제공됩니다. 완료에 실패하면 타이틀에는 [PFLobbyFindLobbiesCompletedStateChange::result](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyfindlobbiescompletedstatechange.md) 필드가 실패로 설정된 [PFLobbyFindLobbiesCompletedStateChange](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyfindlobbiescompletedstatechange.md)가 제공됩니다.

## 요구 사항

**헤더:** PFLobby.h

## 참고 항목

[PFLobby 멤버](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)


## Related topics

- [Integrate Party with Lobby using Multiplayer SDK](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/party-lobby-integration.md)
- [PFLobbySearchConfiguration](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchconfiguration.md)
- [PFLobbySearchResult](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchresult.md)
- [PlayFab Multiplayer C++ SDK 릴리스 정보](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFMultiplayer C/C++ API 개요 - PFLobby.h](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)