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

# XblAchievementsManagerAddLocalUser

> XblAchievementsManagerAddLocalUser

# XblAchievementsManagerAddLocalUser

初始化 Achievements Manager，並為使用者產生成就的本機快取。

## 語法

```cpp theme={null}
HRESULT XblAchievementsManagerAddLocalUser(  
         XblUserHandle user,  
         XTaskQueueHandle queue  
)  
```

### 參數

*user*   \_In\_\
類型：XblUserHandle

要擷取其成就的 XBOX Live 使用者。

*queue*   \_In\_opt\_\
類型：XTaskQueueHandle

用於此使用者背景作業的佇列 (選用)。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

由於 `XblAchievementsManagerAddLocalUser` 需要網際網路連線才能正確追蹤使用者資訊，因此應僅在連線至網際網路時呼叫。使用 [XNetworkingRegisterConnectivityHintChanged](/zh-TW/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged) 是檢查連線的好方法。

如果 Achievements Manager 未初始化，對 [XblAchievementsManagerUpdateAchievement](/zh-TW/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement) 的呼叫將會失敗。在此情況下，應在達成成就條件時改為呼叫 [XblAchievementsUpdateAchievementAsync](/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync)，以確保仍會追蹤進度。以下是實作方式的範例：

```cpp theme={null}
HRESULT hr = XblAchievementsManagerUpdateAchievement(xuid, "2", 3);
if (FAILED(hr))
{
    XAsyncBlock async{};
    hr = XblAchievementsUpdateAchievementAsync(m_xblContext, xuid, "2", 3, &async);
    if (SUCCEEDED(hr))
    {
        // this simple example is thread blocking. 
        // replace with whatever async pattern used by other XAsync calls in title
        XAsyncGetStatus(&async, true); 
    }
}
```

## 需求

**標頭：** 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

- [XBOX 成就管理員 API 概觀](/zh-TW/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerUpdateAchievement](/zh-TW/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)
- [XblAchievementsManagerRemoveLocalUser](/zh-TW/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerremovelocaluser.md)
- [XblSocialManagerAddLocalUser](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanageraddlocaluser.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)