Skip to main content

XStoreGetUserPurchaseIdAsync

Obtient un ID d’achat du client. Cet ID récupère une clé d’ID du Microsoft Store qui peut servir à accorder des droits d’utilisation pour des produits gratuits au nom de l’utilisateur actuel. Cette API est utilisée dans le flux décrit dans Gérer les produits à partir de vos services

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Le handle de contexte de magasin de l’utilisateur retourné par XStoreCreateContext. serviceTicket   _In_z_
Type : char*
Le ticket de service associé à l’achat. publisherUserId   _In_z_
Type : char*
Une chaîne contenant l’ID d’utilisateur de l’éditeur. async   _Inout_
Type : XAsyncBlock*
Un XAsyncBlock qui définit le travail asynchrone en cours. Le XAsyncBlock peut servir à interroger l’état de l’appel et à récupérer les résultats de l’appel. Pour plus d’informations, consultez XAsyncBlock.

Valeur de retour

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

Remarques

Pour récupérer l’ID d’achat du client ainsi que le résultat d’exécution de cette fonction, appelez XStoreGetUserPurchaseIdResult après avoir appelé cette fonction. Pour récupérer la taille de l’ID d’achat du client, appelez XStoreGetUSerPurchaseIdResultSize après avoir appelé cette fonction. Connaître la taille du résultat vous aidera à lire le résultat plus efficacement. L’extrait de code suivant montre un exemple de récupération d’un ID d’achat du client.

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
XStoreGetUserPurchaseIdResult
XStoreGetUSerPurchaseIdResultSize
Gérer les produits à partir de vos services
Last modified on October 6, 2026