Skip to main content

XStoreCreateContext

Crée un contexte de magasin pour l’utilisateur spécifié.

Syntaxe

Paramètres

user   _In_opt_
Type : XUserHandle
L’utilisateur pour lequel créer le contexte de magasin.
Ce paramètre est facultatif pour les jeux sur PC seulement : il suffit de passer une valeur nullptr. Sur PC, l’utilisateur connecté au Microsoft Store est utilisé automatiquement et ce paramètre est ignoré. Un XUser valide est requis pour les jeux sur console.
storeContextHandle   _Out_
Type : XStoreContextHandle*
En cas de réussite, contient le contexte de magasin créé.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.

Remarques

REMARQUE : Sur les consoles, le XStoreContextHandle créé par cette fonction est invalidé après un événement de suspension ou de Quick Resume. Pour gérer ces situations de façon sécuritaire, nous recommandons de fermer le XStoreContextHandle et de le recréer chaque fois que le jeu reprend après un état suspendu.
Cette fonction ne peut pas être appelée de façon sécuritaire sur un thread à contrainte de temps. Pour plus d’informations, consultez Threads à contrainte de temps.
Lorsque vous avez terminé d’utiliser le XStoreContextHandle créé par cette fonction, vous devez le fermer avec XStoreCloseContextHandle. Si vous ne fermez pas le handle, une fuite de mémoire se produira. Le contexte de magasin sert à identifier l’utilisateur pour lequel récupérer des informations dans plusieurs appels de l’API XStore. L’extrait de code suivant montre un exemple de création d’un contexte de magasin.

Configuration requise

En-tête : XStore.h (inclus dans XGameRuntime.h) Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XStore
XStoreCloseContextHandle
XStoreRegisterGameLicenseChanged
Last modified on October 6, 2026