Skip to main content

​
XPersistentLocalStoragePromptUserForSpaceAsync

Allows titles to prompt users to free up a requested total number of Bytes of Growable Persistent Local Storage.

​
Syntax

​
Parameters

requestedBytes   _In_
Type: uint64_t The total amount of space the title wishes to be made available for use. asyncBlock   _Inout_
Type: XAsyncBlock* An XAsyncBlock for monitoring the status of the asynchronous call.

​
Return value

Type: HRESULT Returns S_OK if successful; otherwise, returns an error code. For a list of error codes, see Error Codes.

​
Remarks

Prior to calling, titles should check free space availability by using XPersistentLocalStorageGetSpaceInfo. The result of the request should be checked within the callback function by calling XPersistentLocalStoragePromptUserForSpaceResult. This is not a guarantee that the user freed the requested number of bytes; only that the user took action. Your game should query free space again using XPersistentLocalStorageGetSpaceInfo when the user retries the operation that resulted in the space request. Result of the async operation is E_ABORT if the user chose not to free up space. Persistent Local Storage is not implemented on PC platforms. Although present, this method should not be used on PC. This is disabled on datacenter streaming servers. It will always return E_ABORT when called on datacenter streaming servers.

​
Requirements

Header: XPersistentLocalStorage.h Library: xgameruntime.lib Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

​
Conceptual documentation

​
See also

XPersistentLocalStorage
Last modified on August 20, 2026

Related topics

XPersistentLocalStoragePromptUserForSpaceResultXPersistentLocalStorageXPersistentLocalStorageSpaceInfoUnity C# API wrappers for the GDKXPersistentLocalStorageGetSpaceInfo