Skip to main content

XStoreGetUserPurchaseIdAsync

Obtient un ID d’achat client. Cet ID récupère une clé d’ID Microsoft Store pouvant être utilisée pour accorder des droits d’utilisation sur 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
Handle de contexte de Store de l’utilisateur, renvoyé par XStoreCreateContext. serviceTicket   _In_z_
Type : char*
Ticket de service associé à l’achat. publisherUserId   _In_z_
Type : char*
Chaîne contenant l’ID utilisateur de l’éditeur. 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

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 aide à le lire plus efficacement. L’extrait de code suivant montre un exemple de récupération d’un ID d’achat 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