> ## 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](/ja-jp/services/playfab/api-references/c/pfgamesavefilestypes/enums/pfgamesavefilesadduseroptions)

ユーザーを追加するときに使用するオプション。

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

呼び出しの状態をポーリングし、呼び出しの結果を取得するための XAsyncBlock。

### 戻り値

型: HRESULT

PFGameSaveFilesAddUserWithUiAsync の呼び出し結果を取得するには、PFGameSaveFilesAddUserWithUiResult を呼び出します。この呼び出しが完了した後、PFGameSaveFilesGetFolder を呼び出して、このユーザーのゲーム セーブ ファイルとフォルダーのルート フォルダーを取得できます。ルート フォルダーのすべてのファイルとサブフォルダーはクラウドと同期されます。これはユーザーごとに 1 回だけ呼び出すことができ、通常はゲームのメイン メニューを表示する前に呼び出します。同じユーザーのダウンロードを再度トリガーするには、先に PFGameSaveFilesUninitializeAsync を呼び出して完了するまで待機してください

## 要件

**ヘッダー:** PFGameSaveFiles.h

## 関連項目

[PFGameSaveFiles のメンバー](/ja-jp/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members)


## Related topics

- [PFGameSaveFilesAddUserWithUiResult](/ja-jp/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult.md)
- [PFGameSaveFilesUiSyncFailedUserAction](/ja-jp/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuisyncfaileduseraction.md)
- [Game Saves の UI コールバック](/ja-jp/services/playfab/player-progression/game-saves/ui-callbacks.md)
- [PFGameSaveFilesSetUiCallbacks](/ja-jp/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuicallbacks.md)
- [PFGameSaveFilesIsConnectedToCloud](/ja-jp/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesisconnectedtocloud.md)