> ## 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-TW/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardasync.md)
- [服務 C API 概觀 - PFLeaderboardsTypes.h](/zh-TW/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)
- [PFLeaderboardsGetLeaderboardForEntitiesRequest](/zh-TW/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetleaderboardforentitiesrequest.md)
- [PFLeaderboardsGetFriendLeaderboardForEntityRequest](/zh-TW/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetfriendleaderboardforentityrequest.md)
- [PFLeaderboardsGetLeaderboardAroundEntityRequest](/zh-TW/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetleaderboardaroundentityrequest.md)