> ## 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](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged) の使用があります。

Achievements Manager が初期化されていない場合、[XblAchievementsManagerUpdateAchievement](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement) の呼び出しは失敗します。この場合は、実績条件が満たされた際に、進捗が引き続き追跡されるように、代わりに [XblAchievementsUpdateAchievementAsync](/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](/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members)


## Related topics

- [XBOX Achievements Manager API の概要](/ja-jp/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerUpdateAchievement](/ja-jp/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)
- [XblAchievementsManagerRemoveLocalUser](/ja-jp/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerremovelocaluser.md)
- [XblSocialManagerAddLocalUser](/ja-jp/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanageraddlocaluser.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)