Skip to main content

XStoreCanAcquireLicenseForStoreIdAsync

Récupère une licence d’aperçu pour du contenu pouvant faire l’objet d’une licence, y compris les durables avec ou sans package, et le contenu d’un disque actuellement inséré. Cette API permet au jeu de vérifier si une licence peut être accordée pour le produit, sans réellement acquérir la licence.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Le handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. storeProductId   _In_z_
Type : char*
StoreID du produit à vérifier async   _Inout_
Type : XAsyncBlock*
Un XAsyncBlock qui définit le travail asynchrone en cours. Le XAsyncBlock peut être utilisé pour 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

XStoreCanAcquireLicenseForStoreIdAsync permet à un jeu de déterminer si l’utilisateur pourrait acquérir une licence pour un contenu particulier sans réellement acquérir cette licence ni utiliser l’emplacement de simultanéité de cet utilisateur. Cette fonction n’a pas besoin d’être utilisée pour le jeu en cours d’exécution, puisqu’il possède déjà une licence, mais elle permet de déterminer si l’utilisateur possède d’autres jeux ou contenus du même éditeur. Par exemple, un jeu peut utiliser cette API pour déterminer s’il doit récompenser les utilisateurs qui possèdent des versions antérieures du jeu (en version numérique ou sur un disque inséré) ou pour proposer des produits supplémentaires à l’utilisateur. Pour récupérer la licence d’aperçu et le résultat de l’exécution de cette fonction, appelez XStoreCanAcquireLicenseForStoreIdResult après avoir appelé cette fonction. Cet extrait de code montre un exemple d’utilisation des API suivantes :

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
XStoreCanAcquireLicenseForStoreIdResult
Comment utiliser un durable sans package
Accorder aux joueurs l’accès au contenu de modules complémentaires
Last modified on October 6, 2026