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

# XblLeaderboardGetLeaderboardResult

> XblLeaderboardGetLeaderboardResult

# XblLeaderboardGetLeaderboardResult

获取 XblLeaderboardGetLeaderboardAsync 调用的结果。

## 语法

```cpp theme={null}
HRESULT XblLeaderboardGetLeaderboardResult(  
         XAsyncBlock* async,  
         size_t bufferSize,  
         void* buffer,  
         XblLeaderboardResult** ptrToBuffer,  
         size_t* bufferUsed  
)  
```

### 参数

*async*   \_In\_\
类型：XAsyncBlock\*

此操作的 AsyncBlock。

*bufferSize*   \_In\_\
类型：size\_t

所提供缓冲区的大小。使用 [XblLeaderboardGetLeaderboardResultSize](/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardresultsize) 获取所需的大小。

*buffer*   \_Out\_writes\_bytes\_to\_(bufferSize,*bufferUsed)\
类型：void*

用于写入结果的调用方分配的字节缓冲区。

*ptrToBuffer*   \_Outptr\_\
类型：[XblLeaderboardResult\*\*](/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardresult)

指向缓冲区的强类型指针。请勿释放此指针，因为其生命周期与缓冲区绑定。

*bufferUsed*   \_Out\_opt\_\
类型：size\_t\*

写入缓冲区的字节数。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 要求

**头文件：** leaderboard\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[leaderboard\_c](/reference/live/xsapi-c/leaderboard_c/leaderboard_c_members)


## Related topics

- [XblLeaderboardResult](/zh-CN/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardresult.md)
- [XblLeaderboardResultGetNextAsync](/zh-CN/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardresultgetnextasync.md)
- [基于事件的排行榜示例代码](/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-leaderboards-eb-howto.md)
- [获取标题管理的排行榜](/zh-CN/services/xbox-services/player-data/stats-leaderboards/title-managed/how-to/live-getting-tm-leaderboard.md)
- [排行榜](/zh-CN/build/steam-porting-guide/features/steam-leaderboards.md)