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

# 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](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry.md) const\*\
*may be nullptr*

(省略可) リクエストに関連付けられた任意のカスタム タグ (例: ビルド番号、外部トレース識別子など)。

**`customTagsCount`**   uint32\_t

customTags の数。

**`entity`**   [PFEntityKey](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pftypes/structs/pfentitykey-c.md) const\*\
*may be nullptr*

(省略可) このアクションを実行する対象のエンティティ (省略可能)。既定では現在ログインしているエンティティになります。

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

リーダーボードの名前。

**`maxSurroundingEntries`**   uint32\_t

返される周辺エントリの数 (指定したエンティティに加えて)。一般に、上位と下位のランク数は半分ずつに分割されます。たとえば、指定した値が 10 の場合、上位 5 ランクと下位 5 ランクが取得されます。ただし、指定したエンティティがリーダーボードの上部または下部に近い場合、その数はどちらかの方向に偏ります。また、リーダーボードの下部にあるエントリでは、返されるエントリの数が指定した値より少なくなることがあります。

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

(省略可) リーダーボードのバージョン (省略可能)。既定では現在のバージョンになります。

## 要件

**ヘッダー:** PFLeaderboardsTypes.h

## 関連項目

[PFLeaderboardsTypes のメンバー](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)


## Related topics

- [PFLeaderboardsGetLeaderboardAroundEntityAsync](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardaroundentityasync.md)
- [Services C API overview - PFLeaderboardsTypes.h](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)
- [Get Leaderboard Around Entity](https://docs.xbox.com/api-reference/leaderboards/get-leaderboard-around-entity.md)
- [PFLeaderboardsGetLeaderboardAroundEntityGetResult](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardaroundentitygetresult.md)
- [PFLeaderboardsGetLeaderboardAroundEntityGetResultSize](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardaroundentitygetresultsize.md)