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

# PFLeaderboardsGetLeaderboardAroundEntityRequest

> PFLeaderboardsGetLeaderboardAroundEntityRequest 데이터 모델입니다. 특정 엔터티를 중심으로 리더보드의 한 구간을 로드하기 위한 요청입니다.

PFLeaderboardsGetLeaderboardAroundEntityRequest 데이터 모델입니다. 특정 엔터티를 중심으로 리더보드의 한 구간을 로드하기 위한 요청입니다.

## 구문

```cpp theme={null}
typedef struct PFLeaderboardsGetLeaderboardAroundEntityRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFEntityKey const* entity;  
    const char* leaderboardName;  
    uint32_t maxSurroundingEntries;  
    uint32_t const* version;  
} PFLeaderboardsGetLeaderboardAroundEntityRequest;  
```

### 멤버

**`customTags`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

(선택 사항) 요청과 연결된 선택적 사용자 지정 태그입니다(예: 빌드 번호, 외부 추적 식별자 등).

**`customTagsCount`**   uint32\_t

customTags의 개수입니다.

**`entity`**   [PFEntityKey](/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*<br />*may be nullptr*

(선택 사항) 이 작업을 수행할 선택적 엔터티입니다. 기본값은 현재 로그인한 엔터티입니다.

**`leaderboardName`**   const char\*<br />*is null-terminated*

리더보드의 이름입니다.

**`maxSurroundingEntries`**   uint32\_t

반환할 주변 항목 수입니다(지정된 엔터티에 추가로). 일반적으로 위와 아래의 순위 수는 절반으로 나뉩니다. 예를 들어 지정된 값이 10이면 위 5개 순위와 아래 5개 순위가 검색됩니다. 그러나 지정된 엔터티가 리더보드의 상단이나 하단에 가까우면 숫자가 한쪽으로 치우치게 됩니다. 또한 리더보드 하단에 있는 항목의 경우 반환되는 항목 수가 지정된 값보다 적을 수 있습니다.

**`version`**   uint32\_t const\*<br />*may be nullptr*

(선택 사항) 리더보드의 선택적 버전이며, 기본값은 현재 버전입니다.

## 요구 사항

**헤더:** PFLeaderboardsTypes.h

## 참고 항목

[PFLeaderboardsTypes 멤버](/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members)


## Related topics

- [PFLeaderboardsGetLeaderboardAroundEntityAsync](/ko/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardaroundentityasync.md)
- [Services C API 개요 - PFLeaderboardsTypes.h](/ko/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)
- [PFLeaderboardsGetLeaderboardAroundEntityGetResult](/ko/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardaroundentitygetresult.md)
- [PFLeaderboardsGetLeaderboardAroundEntityGetResultSize](/ko/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardaroundentitygetresultsize.md)
- [PFLeaderboardsGetEntityLeaderboardRequest](/ko/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetentityleaderboardrequest.md)