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

> 將使用者新增至遊戲存檔系統。這會視需要從雲端下載存檔狀態，並可能觸發下列 UI 回呼：PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback、PFGameSaveFilesUiActiveDeviceContentionCallback、PFGameSaveFilesUiConflictCallback、PFGameSaveFilesUiOutOfStorageCallback。如需詳細資訊，請參閱 PFGameSaveFilesSetUiCallbacks。必須先呼叫 PFGameSaveFilesInitialize。在 XBOX 和 Windows 平台上，系統會提供內建 UI。

將使用者新增至遊戲存檔系統。這會視需要從雲端下載存檔狀態，並可能觸發下列 UI 回呼：PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback、PFGameSaveFilesUiActiveDeviceContentionCallback、PFGameSaveFilesUiConflictCallback、PFGameSaveFilesUiOutOfStorageCallback。如需詳細資訊，請參閱 PFGameSaveFilesSetUiCallbacks。必須先呼叫 PFGameSaveFilesInitialize。在 XBOX 和 Windows 平台上，系統會提供內建 UI。

## 語法

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

### 參數

**`localUserHandle`**   PFLocalUserHandle

要新增的本機使用者。

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

新增使用者時要使用的選項。

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

用於輪詢呼叫狀態及擷取呼叫結果的 XAsyncBlock。

### 傳回值

類型：HRESULT

若要擷取 PFGameSaveFilesAddUserWithUiAsync 呼叫的結果，請呼叫 PFGameSaveFilesAddUserWithUiResult。此呼叫完成後，您可以呼叫 PFGameSaveFilesGetFolder 以取得此使用者之遊戲存檔檔案和資料夾的根資料夾。根資料夾的所有檔案和子資料夾都會與雲端同步。每位使用者只能呼叫一次，通常是在顯示遊戲主功能表之前。若要為同一位使用者重新觸發下載，請先呼叫 PFGameSaveFilesUninitializeAsync 並等候其完成

## 需求

**標頭：** PFGameSaveFiles.h

## 另請參閱

[PFGameSaveFiles 成員](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members)


## Related topics

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