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

# PFLeaderboardsGetEntityLeaderboardRequest

> PFLeaderboardsGetEntityLeaderboardRequest 데이터 모델입니다. 리더보드를 로드하기 위한 요청입니다.

PFLeaderboardsGetEntityLeaderboardRequest 데이터 모델입니다. 리더보드를 로드하기 위한 요청입니다.

## 구문

```cpp theme={null}
typedef struct PFLeaderboardsGetEntityLeaderboardRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    const char* leaderboardName;  
    uint32_t pageSize;  
    uint32_t const* startingPosition;  
    uint32_t const* version;  
} PFLeaderboardsGetEntityLeaderboardRequest;  
```

### 멤버

**`customTags`**   [PFStringDictionaryEntry](https://docs.xbox.com/ko/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry.md) const\*\
*may be nullptr*

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

**`customTagsCount`**   uint32\_t

customTags의 개수입니다.

**`leaderboardName`**   const char\*\
*is null-terminated*

리더보드의 이름입니다.

**`pageSize`**   uint32\_t

리더보드에서 반환할 최대 결과 수입니다. 최소 1, 최대 100입니다.

**`startingPosition`**   uint32\_t const\*\
*may be nullptr*

(선택 사항) 시작할 인덱스 위치입니다. 1은 리더보드의 시작입니다.

**`version`**   uint32\_t const\*\
*may be nullptr*

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

## 요구 사항

**헤더:** PFLeaderboardsTypes.h

## 참고 항목

[PFLeaderboardsTypes 멤버](https://docs.xbox.com/ko/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)


## Related topics

- [PFLeaderboardsGetLeaderboardAsync](https://docs.xbox.com/ko/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardasync.md)
- [Services C API 개요 - PFLeaderboardsTypes.h](https://docs.xbox.com/ko/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)
- [PFLeaderboardsGetLeaderboardForEntitiesRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetleaderboardforentitiesrequest.md)
- [PFLeaderboardsGetFriendLeaderboardForEntityRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetfriendleaderboardforentityrequest.md)
- [PFLeaderboardsGetLeaderboardAroundEntityRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetleaderboardaroundentityrequest.md)