> ## 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 개요](/ko/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerUpdateAchievement](/ko/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)
- [XblAchievementsManagerRemoveLocalUser](/ko/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerremovelocaluser.md)
- [XblSocialManagerAddLocalUser](/ko/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanageraddlocaluser.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)