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

# PFGameSaveFilesAddUserWithUiAsync

> 게임 저장 시스템에 사용자를 추가합니다. 필요에 따라 클라우드에서 저장 상태를 다운로드하며, PFGameSaveFilesUiProgressCallback, PFGameSaveFilesUiSyncFailedCallback, PFGameSaveFilesUiActiveDeviceContentionCallback, PFGameSaveFilesUiConflictCallback, PFGameSaveFilesUiOutOfStorageCallback UI 콜백을 트리거할 수 있습니다. 자세한 내용은 PFGameSaveFilesSetUiCallbacks를 참조하세요. PFGameSaveFilesInitialize를 먼저 호출해야 합니다. XBOX 및 Windows 플랫폼에서는 시스템에서 기본 UI를 제공합니다.

게임 저장 시스템에 사용자를 추가합니다. 필요에 따라 클라우드에서 저장 상태를 다운로드하며, PFGameSaveFilesUiProgressCallback, PFGameSaveFilesUiSyncFailedCallback, PFGameSaveFilesUiActiveDeviceContentionCallback, PFGameSaveFilesUiConflictCallback, PFGameSaveFilesUiOutOfStorageCallback UI 콜백을 트리거할 수 있습니다. 자세한 내용은 PFGameSaveFilesSetUiCallbacks를 참조하세요. PFGameSaveFilesInitialize를 먼저 호출해야 합니다. XBOX 및 Windows 플랫폼에서는 시스템에서 기본 UI를 제공합니다.

## 구문

```cpp theme={null}
HRESULT PFGameSaveFilesAddUserWithUiAsync(  
    PFLocalUserHandle localUserHandle,  
    PFGameSaveFilesAddUserOptions options,  
    XAsyncBlock* async  
)  
```

### 매개 변수

**`localUserHandle`**   PFLocalUserHandle

추가할 로컬 사용자입니다.

**`options`**   [PFGameSaveFilesAddUserOptions](/ko/services/playfab/api-references/c/pfgamesavefilestypes/enums/pfgamesavefilesadduseroptions)

사용자를 추가할 때 사용할 옵션입니다.

**`async`**   XAsyncBlock\*<br />*Inout*

호출 상태를 폴링하고 호출 결과를 검색하기 위한 XAsyncBlock입니다.

### 반환 값

형식: HRESULT

PFGameSaveFilesAddUserWithUiAsync 호출의 결과를 검색하려면 PFGameSaveFilesAddUserWithUiResult를 호출합니다. 이 호출이 완료된 후 PFGameSaveFilesGetFolder를 호출하여 이 사용자의 게임 저장 파일 및 폴더의 루트 폴더를 가져올 수 있습니다. 루트 폴더의 모든 파일과 하위 폴더는 클라우드와 동기화됩니다. 이 함수는 사용자당 한 번만 호출할 수 있으며, 일반적으로 게임의 주 메뉴를 표시하기 전에 호출합니다. 동일한 사용자에 대해 다운로드를 다시 트리거하려면 먼저 PFGameSaveFilesUninitializeAsync를 호출하고 완료될 때까지 기다리세요.

## 요구 사항

**헤더:** PFGameSaveFiles.h

## 참고 항목

[PFGameSaveFiles 멤버](/ko/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members)


## Related topics

- [PFGameSaveFilesAddUserWithUiResult](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult.md)
- [Game Saves UI 콜백](/ko/services/playfab/player-progression/game-saves/ui-callbacks.md)
- [PFGameSaveFilesUiSyncFailedUserAction](/ko/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuisyncfaileduseraction.md)
- [PFGameSaveFilesSetUiCallbacks](/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuicallbacks.md)
- [PFGameSaveFilesIsConnectedToCloud](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesisconnectedtocloud.md)