Skip to main content

XStoreShowPurchaseUIAsync

Lance la superposition de l’interface utilisateur d’achat pour le produit spécifié.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. storeId   _In_z_
Type : char*
ID du produit à acheter. name   _In_opt_z_
Type : char*
Nom du produit à acheter. extendedJsonData   _In_opt_z_
Type : char*
Blob JSON transmis au flux d’achat. Permet d’insérer des ID de campagne personnalisés afin de suivre l’origine de l’achat. async   _Inout_
Type : XAsyncBlock*
Un XAsyncBlock définissant le travail asynchrone en cours. Le XAsyncBlock peut être utilisé pour interroger l’état de l’appel et récupérer ses résultats. Pour plus d’informations, consultez XAsyncBlock.

Valeur de retour

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

Remarques

![NOTE] Cette opération ne déclenche pas le téléchargement ni l’installation des éléments après un achat attendu. Si vous souhaitez télécharger et installer ce contenu, il est recommandé d’appeler XStoreDownloadAndInstallPackagesAsync après un achat réussi. Aucune invite supplémentaire ne sera présentée à l’utilisateur.
![NOTE] Sur PC, la boîte de dialogue de confirmation d’achat qui s’affiche après un achat réussi comporte un bouton de fermeture [X] en haut. Sélectionner ce bouton au lieu de Ok entraîne le retour de E_ABORT à XStoreShowPurchaseUIResult, ce qui n’est pas forcément souhaité. Il s’agit du comportement standard de Windows lorsqu’une boîte de dialogue est fermée de cette manière.
Pour récupérer le résultat de cette fonction, appelez XStoreShowPurchaseUIResult après avoir appelé cette fonction. Cette fonction ne doit être appelée que lorsque l’utilisateur a choisi d’acheter quelque chose ; elle amène le système à présenter une boîte de dialogue d’achat modale qui gère les informations de paiement et la confirmation de l’utilisateur hors processus. L’extrait de code suivant montre un exemple de demande d’achat pour un produit particulier du 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
XStoreShowPurchaseUIResult
Last modified on October 6, 2026