Skip to main content

XGameSaveGetContainerInfo

Récupère les informations des conteneurs d’un XGameSaveProvider.

Syntaxe

Paramètres

provider   _In_
Type : XGameSaveProviderHandle
Handle XGameSaveProvider contenant le conteneur souhaité. containerName   _In_z_
Type : char*
Nom du conteneur dont les informations doivent être récupérées ; un seul résultat est renvoyé s’il est trouvé. Si vous souhaitez obtenir plusieurs conteneurs, utilisez XGameSaveEnumerateContainerInfo ou XGameSaveEnumerateContainerInfoByName. context   _In_opt_
Type : void*
Pointeur vers l’objet appelant, pour le contexte. callback   _In_
Type : XGameSaveContainerInfoCallback*
Fonction de rappel permettant de déterminer les résultats de l’appel XGameSaveContainerInfo et d’en collecter les données.

Valeur de retour

Type : HRESULT Résultat de la fonction

Erreurs courantes

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_USER_CANCELED
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

Remarques

Cette fonction ne peut pas être appelée sans risque sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.
Un conteneur est une collection de métadonnées et un point de référence pour l’ensemble des blobs qu’il contient. Si le nom du conteneur est connu à l’avance, il est possible d’utiliser cette API pour renvoyer les informations de ce seul conteneur. Cela est utile pour récupérer des informations spécifiques sur un joueur au lieu de toutes les demander chaque fois que vous avez besoin d’informations. Vous trouverez la composition d’un XGameSaveContainer dans la structure XGameSaveContainerInfo.

Configuration requise

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

Documentation conceptuelle

Voir aussi

XGameSave
XGameSaveCreateContainer
XGameSaveContainerInfo
Débogage des sauvegardes de jeu
Last modified on October 6, 2026