Skip to main content

XStoreAcquireLicenseForDurablesAsync

Acquiert une licence pour un DLC (durable avec un package), un durable sans package ou un produit de module complémentaire durable.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Le handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. storeId   _In_z_
Type : char*
L’ID Store du durable pour lequel acquérir une licence. async   _Inout_
Type : XAsyncBlock*
Un XAsyncBlock qui définit le travail asynchrone. Utilisez le XAsyncBlock pour vérifier l’état de l’appel et obtenir les résultats de l’appel. Pour plus d’informations, consultez XAsyncBlock.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite, ou un code d’erreur dans le cas contraire.

Remarques

Cette API tente d’acquérir une licence pour le durable demandé. S’il s’agit de la première fois que l’appareil acquiert la licence, un appel de service est effectué, ce qui nécessite une connexion en ligne. Les appels suivants pour la même licence peuvent être plus rapides grâce à la mise en cache, mais la licence peut être invalidée à tout moment. Sur console, l’accès hors ligne exige que l’option « XBOX principale » soit activée pour le compte propriétaire et que la licence ait d’abord été obtenue une fois en ligne. Sur PC, l’accès hors ligne exige que les « Autorisations hors connexion » soient définies pour le compte propriétaire de la licence et que la licence ait d’abord été obtenue une fois en ligne. XStoreRegisterPackageLicenseLost peut être utilisée pour surveiller si la licence obtenue à partir de cette API est perdue.

Configuration requise

En-tête : XStore.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
XAsyncBlock
XStoreAcquireLicenseForDurablesResult
Comment utiliser un durable sans package
Accorder aux joueurs l’accès au contenu de modules complémentaires
Last modified on October 6, 2026