> ## 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](/zh-TW/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardaroundentityasync.md)
- [服務 C API 概觀 - PFLeaderboardsTypes.h](/zh-TW/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)
- [PFLeaderboardsGetLeaderboardAroundEntityGetResult](/zh-TW/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardaroundentitygetresult.md)
- [PFLeaderboardsGetLeaderboardAroundEntityGetResultSize](/zh-TW/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardaroundentitygetresultsize.md)
- [PFLeaderboardsGetEntityLeaderboardRequest](/zh-TW/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetentityleaderboardrequest.md)