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 sur lequel récupérer des informations; un seul résultat est retourné s’il est trouvé. Si vous souhaitez obtenir plus d’un conteneur, 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 danger sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
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 retourner les informations de ce conteneur uniquement. C’est utile pour récupérer des informations précises 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