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

# PFLeaderboardsGetLeaderboardAsync

> 取得特定實體類型和統計資料的排行榜。

取得特定實體類型和統計資料的排行榜。

## 語法

```cpp theme={null}
HRESULT PFLeaderboardsGetLeaderboardAsync(  
    PFEntityHandle entityHandle,  
    const PFLeaderboardsGetEntityLeaderboardRequest* request,  
    XAsyncBlock* async  
)  
```

### 參數

**`entityHandle`**   PFEntityHandle

用於驗證的 PFEntityHandle。

**`request`**   [PFLeaderboardsGetEntityLeaderboardRequest\*](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetentityleaderboardrequest.md)

已填入的要求物件。

**`async`**   XAsyncBlock\*\
*Inout*

用於非同步作業的 XAsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的結果代碼。

## 備註

此 API 適用於所有平台。當非同步工作完成時，請呼叫 [PFLeaderboardsGetLeaderboardGetResultSize](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardgetresultsize.md) 和 [PFLeaderboardsGetLeaderboardGetResult](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardgetresult.md) 以取得結果。

## 需求

**標頭：** PFLeaderboards.h

## 另請參閱

[PFLeaderboards 成員](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfleaderboards/pfleaderboards_members.md)


## Related topics

- [PFLeaderboardsGetLeaderboardGetResult](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardgetresult.md)
- [服務 C API 概觀 - PFLeaderboards.h](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfleaderboards/pfleaderboards_members.md)
- [XblLeaderboardGetLeaderboardAsync](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardasync.md)
- [PFLeaderboardsGetLeaderboardDefinitionAsync](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboarddefinitionasync.md)
- [PFLeaderboardsGetLeaderboardForEntitiesAsync](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsgetleaderboardforentitiesasync.md)