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

# 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](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

（可选）与请求关联的可选自定义标记（例如内部版本号、外部跟踪标识符等）。

**`customTagsCount`**   uint32\_t

customTags 的计数

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

排行榜的名称。

**`pageSize`**   uint32\_t

要从排行榜返回的最大结果数。最小为 1，最大为 100。

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

（可选）开始的索引位置。1 表示排行榜的开头。

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

（可选）排行榜的可选版本，默认为当前版本。

## 要求

**头文件：** PFLeaderboardsTypes.h

## 另请参阅

[PFLeaderboardsTypes 成员](/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members)


## Related topics

- [PFLeaderboardsGetLeaderboardAsync](/zh-CN/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardasync.md)
- [服务 C API 概览 - PFLeaderboardsTypes.h](/zh-CN/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)
- [PFLeaderboardsGetLeaderboardForEntitiesRequest](/zh-CN/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetleaderboardforentitiesrequest.md)
- [PFLeaderboardsGetFriendLeaderboardForEntityRequest](/zh-CN/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetfriendleaderboardforentityrequest.md)
- [PFLeaderboardsGetLeaderboardAroundEntityRequest](/zh-CN/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetleaderboardaroundentityrequest.md)