XStoreShowGiftingUIAsync
Lance la superposition d’interface utilisateur permettant d’acheter le produit spécifié en tant que cadeau pour un autre utilisateur. L’utilisateur actuel est invité à saisir des informations sur le destinataire du cadeau, puis il est guidé tout au long du processus d’achat.Syntaxe
Paramètres
storeContextHandle _In_Type : XStoreContextHandle Handle de contexte du Store de l’utilisateur, retourné par XStoreCreateContext. storeId _In_z_
Type : char* ID du produit à acheter en tant que cadeau. Remarque : ce produit doit être configuré pour prendre en charge les achats de cadeaux. name _In_opt_z_
Type : char* Nom du produit à acheter en tant que cadeau. extendedJsonData _In_opt_z_
Type : char* Blob JSON transmis au processus d’achat de cadeau. Permet d’insérer des ID de campagne personnalisés afin de suivre l’origine de l’achat. async _Inout_
Type : XAsyncBlock* 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
Le produit à acheter en tant que cadeau doit être configuré pour prendre en charge les achats de cadeaux. Pour récupérer la liste des produits qui prennent en charge les cadeaux, appelez XStoreQueryProductsAsync avec le paramètreactionFilters défini sur "Gift".
Pour récupérer le résultat de cette fonction, appelez XStoreShowGiftingUIResult après avoir appelé cette fonction. Cette fonction ne doit être appelée que lorsque l’utilisateur a choisi d’acheter quelque chose en tant que cadeau ; 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 de cadeau pour un produit Store particulier.
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 SeriesVoir aussi
XStoreXStoreShowGiftingUIResult
