Skip to main content

XPersistentLocalStoragePromptUserForSpaceAsync

タイトルが、拡張可能な永続ローカル ストレージにおいて要求された合計バイト数の空き領域を確保するようユーザーに促すことを可能にします。

Syntax

Parameters

requestedBytes   _In_
型: uint64_t
タイトルが使用可能にしたい領域の合計量。 asyncBlock   _Inout_
型: XAsyncBlock*
非同期呼び出しの状態を監視するための XAsyncBlock。

Return value

型: HRESULT 成功した場合は S_OK を返します。そうでない場合はエラー コードを返します。エラー コードの一覧については、エラー コード を参照してください。

Remarks

呼び出す前に、タイトルは XPersistentLocalStorageGetSpaceInfo を使用して空き領域の可用性を確認する必要があります。 要求の結果は、コールバック関数内で XPersistentLocalStoragePromptUserForSpaceResult を呼び出して確認する必要があります。これは、ユーザーが要求されたバイト数を実際に解放したことを保証するものではなく、ユーザーがアクションを実行したことのみを保証します。ユーザーが領域要求の原因となった操作を再試行するときに、ゲームは XPersistentLocalStorageGetSpaceInfo を再度使用して空き領域を照会する必要があります。ユーザーが領域の解放を選択しなかった場合、非同期操作の結果は E_ABORT になります。 永続ローカル ストレージは PC プラットフォームでは実装されていません。存在はしますが、このメソッドを PC で使用しないでください。 これはデータセンター ストリーミング サーバーでは無効になっています。データセンター ストリーミング サーバーで呼び出された場合、常に E_ABORT を返します。

Requirements

ヘッダー: XPersistentLocalStorage.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

XPersistentLocalStorage
最終更新日 2026年8月24日