Skip to main content

​
XPersistentLocalStoragePromptUserForSpaceAsync

Permet aux titres d’inviter les utilisateurs à libérer un nombre total d’octets demandé de stockage local persistant extensible.

​
Syntaxe

​
Paramètres

requestedBytes   _In_
Type : uint64_t Quantité totale d’espace que le titre souhaite rendre disponible. asyncBlock   _Inout_
Type : XAsyncBlock* XAsyncBlock permettant de surveiller l’état de l’appel asynchrone.

​
Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.

​
Remarques

Avant l’appel, les titres doivent vérifier l’espace libre disponible à l’aide de XPersistentLocalStorageGetSpaceInfo. Le résultat de la demande doit être vérifié dans la fonction de rappel en appelant XPersistentLocalStoragePromptUserForSpaceResult. Cela ne garantit pas que l’utilisateur a libéré le nombre d’octets demandé, mais seulement qu’il a effectué une action. Votre jeu doit interroger de nouveau l’espace libre à l’aide de XPersistentLocalStorageGetSpaceInfo lorsque l’utilisateur réessaie l’opération à l’origine de la demande d’espace. Le résultat de l’opération asynchrone est E_ABORT si l’utilisateur a choisi de ne pas libérer d’espace. Le stockage local persistant n’est pas implémenté sur les plateformes PC. Bien qu’elle soit présente, cette méthode ne doit pas être utilisée sur PC. Cette fonctionnalité est désactivée sur les serveurs de streaming des centres de données. Elle retourne toujours E_ABORT lorsqu’elle est appelée sur les serveurs de streaming des centres de données.

​
Configuration requise

En-tête : XPersistentLocalStorage.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

​
Documentation conceptuelle

​
Voir aussi

XPersistentLocalStorage
Last modified on October 6, 2026