> ## 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\*\*](/zh-TW/reference/live/xsapi-c/achievements_manager_c/structs/xblachievementsmanagerevent)

傳回指標，指向自上次呼叫 XblAchievementsManagerDoWork 以來發生的成就事件陣列。

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

傳回成就事件陣列中的事件數目。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

必須每個畫面格都呼叫，資料才會保持最新。傳回的成就事件陣列僅在下次呼叫 [XblAchievementsManagerDoWork](/zh-TW/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerdowork) 之前有效。請務必檢查是否有傳回成就事件。如果成就事件陣列為 null，則沒有結果。如果成就事件計數為 0，則沒有結果。如果有傳回成就事件，請依據各自的 [XblAchievementsManagerEventType](/zh-TW/reference/live/xsapi-c/achievements_manager_c/enums/xblachievementsmanagereventtype) 處理每個 [XblAchievementsManagerEvent](/zh-TW/reference/live/xsapi-c/achievements_manager_c/structs/xblachievementsmanagerevent)。

## 需求

**標頭：** achievements\_manager\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

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


## Related topics

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