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

# XblAchievementsManagerDoWork

> XblAchievementsManagerDoWork

# XblAchievementsManagerDoWork

当标题希望更新成就状态并获取更改事件列表时调用。

## 语法

```cpp theme={null}
HRESULT XblAchievementsManagerDoWork(  
         const XblAchievementsManagerEvent** achievementsEvents,  
         size_t* achievementsEventsCount  
)  
```

### 参数

*achievementsEvents*   \_Outptr\_result\_maybenull\_\
类型：[XblAchievementsManagerEvent\*\*](/reference/live/xsapi-c/achievements_manager_c/structs/xblachievementsmanagerevent)

传回一个指针，指向自上次调用 XblAchievementsManagerDoWork 以来发生的成就事件数组。

*achievementsEventsCount*   \_Out\_\
类型：size\_t\*

传回成就事件数组中的事件数量。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

必须每帧调用此函数，数据才能保持最新。返回的成就事件数组仅在下一次调用 [XblAchievementsManagerDoWork](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerdowork) 之前有效。请务必检查是否有返回的成就事件。如果成就事件数组为 null，则表示无结果。如果成就事件计数为 0，则表示无结果。若存在返回的成就事件，则根据每个 [XblAchievementsManagerEvent](/reference/live/xsapi-c/achievements_manager_c/structs/xblachievementsmanagerevent) 对应的 [XblAchievementsManagerEventType](/reference/live/xsapi-c/achievements_manager_c/enums/xblachievementsmanagereventtype) 分别加以处理。

## 要求

**头文件：** achievements\_manager\_c.h

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

## 另请参阅

[achievements\_manager\_c](/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members)


## Related topics

- [XblAchievementsManagerEvent](/zh-CN/reference/live/xsapi-c/achievements_manager_c/structs/xblachievementsmanagerevent.md)
- [XBOX 成就管理器 API 概述](/zh-CN/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblMultiplayerManagerDoWork](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md)
- [XblSocialManagerDoWork](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork.md)
- [XblAchievementsManagerUpdateAchievement](/zh-CN/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)