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

# PFLobbySearchConfiguration

> PFMultiplayerFindLobbies에 대한 구성 구조체: 로비 검색에 대한 친구 필터, 필터 문자열, 정렬 문자열 및 클라이언트 검색 결과 수를 지정합니다.

[PFMultiplayerFindLobbies](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) 작업을 수행하는 방법을 지정하는 데 사용되는 구성 구조입니다.

## 구문

```cpp theme={null}
struct PFLobbySearchConfiguration {  
    const PFLobbySearchFriendsFilter* friendsFilter;  
    const char* filterString;  
    const char* sortString;  
    const uint32_t* clientSearchResultCount;  
}  
```

### 멤버

**`friendsFilter`**   const [PFLobbySearchFriendsFilter](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysearchfriendsfilter)\*\
*nullptr일 수 있음*

제공된 경우 로비 검색 작업을 해당 플레이어의 여러 친구 목록 멤버가 소유한 로비로만 제한하는 필터입니다.

생략되면 검색 작업은 사용 가능한 모든 로비를 검색합니다. <br /><br /> 이 값은 [PFMultiplayerFindLobbies](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies)를 title\_player\_account 엔터티로 호출할 때만 지정할 수 있습니다.

**`filterString`**   const char\*\
*null로 종료됨*

검색 결과에서 반환되는 로비를 필터링하는 데 사용되는 쿼리 문자열입니다.

이 문자열은 OData와 유사한 필터링 구문으로 형식이 지정됩니다. <br /><br /> 다음 연산자만 지원됩니다. "and"(논리 and), "eq"(같음), "ne"(같지 않음), "ge"(크거나 같음), "gt"(큼), "le"(작거나 같음), "lt"(작음).   <br /><br /> 각 OData 논리 식의 왼쪽은 검색 속성 키(예: string\_key1, number\_key3 등) 또는 미리 정의된 검색 키 중 하나(`PFLobbyMemberCountSearchKey`, `PFLobbyAmMemberSearchKey` 또는 `PFLobbyMembershipLockSearchKey`)여야 합니다.   <br /><br /> 각 OData 논리 식의 왼쪽은 검색 속성 키여야 합니다.   <br /><br /> 이 문자열은 500자를 초과할 수 없습니다.   <br /><br /> 예: "lobby/membershipLock eq 'Unlocked' and string\_key1 eq 'CaptureTheFlag' and number\_key10 gt 50 and lobby/memberCount lt 5"

**`sortString`**   const char\*\
*null로 종료됨*

검색 결과에서 반환된 로비를 정렬하는 데 사용되는 쿼리 문자열입니다.

이 문자열은 OData와 유사한 order-by 구문으로 형식이 지정됩니다. 오름차순 또는 내림차순으로 정렬하는 선택적 지정자와 함께 쉼표로 구분된 검색 속성 키 목록입니다. <br /><br /> 오름차순을 지정하려면 관련된 검색 속성 키 뒤에 "asc" 연산자를 사용합니다. 내림차순을 지정하려면 관련된 검색 속성 키 뒤에 "desc" 연산자를 사용합니다.   <br /><br /> 또한 일부 숫자 값과의 가장 가까운 거리로 정렬을 활성화하기 위해 특별한 정렬 이름인 distance가 지원됩니다. 예를 들어 "distance\{number\_key10=5} asc"는 "number\_key10" 검색 속성이 값 "5"에 더 가까운 로비가 검색 결과에서 먼저 반환되도록 결과를 정렬합니다.   <br /><br /> 이 문자열은 100자를 초과할 수 없습니다.   <br /><br /> 예: "string\_key1 asc,lobby/memberCount desc"

**`clientSearchResultCount`**   const uint32\_t\*\
*nullptr일 수 있음*

title\_player\_account 엔터티에 의해 지정된 경우 완료 응답에서 제공되는 결과 수를 제한하는 선택적 값입니다.

이 값은 [PFMultiplayerFindLobbies](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies)를 title\_player\_account 엔터티로 호출할 때만 지정할 수 있습니다. <br /><br /> 이 값은 `PFLobbyClientRequestedSearchResultCountUpperLimit`보다 클 수 없습니다.   <br /><br /> 지정하지 않으면 검색 결과 수의 제한은 서비스에서 정의되지만 `PFLobbyClientRequestedSearchResultCountUpperLimit`보다 크지 않습니다.

## 요구 사항

**헤더:** PFLobby.h

## 참고 항목

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


## Related topics

- [PFLobby Search Keys](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/constants/pflobbysearchkeys.md)
- [PFMultiplayerFindLobbies](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies.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)
- [LobbySearchConfiguration](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchConfiguration/LobbySearchConfiguration.md)