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 SeriesDocumentation conceptuelle
- Implémenter des achats dans le jeu
- Opérations de base du Store
- Gérer et concéder sous licence du contenu téléchargeable (DLC)
- Résolution des problèmes de développement XStore
Voir aussi
XStoreXStoreShowPurchaseUIResult
