Skip to main content

XStoreCreateContext

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

Syntaxe

Paramètres

user   _In_opt_
Type : XUserHandle
Utilisateur pour lequel créer le contexte de Store.
Ce paramètre est facultatif pour les jeux PC uniquement : passez simplement 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 Store 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 en toute sécurité, nous vous recommandons de fermer le XStoreContextHandle et de le recréer chaque fois que le jeu reprend après un état suspendu.
Cette fonction n’est pas sûre à appeler 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 produit. Le contexte de Store sert à identifier l’utilisateur pour lequel récupérer des informations dans un certain nombre d’appels d’API XStore. L’extrait de code suivant montre un exemple de création d’un contexte de Store.

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