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