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

# 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\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

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

**`searchConfiguration`**   [PFLobbySearchConfiguration\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchconfiguration)

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

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

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

### 반환 값

형식: HRESULT

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

## 설명

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

## 요구 사항

**헤더:** PFLobby.h

## 참고 항목

[PFLobby 멤버](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

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