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 La quantité totale d’espace que le titre souhaite rendre disponible pour utilisation. asyncBlock   _Inout_
Type : XAsyncBlock* Un 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é, seulement qu’il a agi. Votre jeu doit interroger de nouveau l’espace libre à l’aide de XPersistentLocalStorageGetSpaceInfo lorsque l’utilisateur relance l’opération ayant entraîné 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 fonction est désactivée sur les serveurs de diffusion en continu des centres de données. Elle retourne toujours E_ABORT lorsqu’elle est appelée sur ces serveurs.

​
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