Skip to main content

XStoreAcquireLicenseForDurablesAsync

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

Syntaxe

Paramètres

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

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur.

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 connexion nécessite que l’option « XBOX principale » soit activée pour le compte propriétaire, et la licence doit d’abord être obtenue une fois en ligne. Sur PC, l’accès hors connexion nécessite que les « Autorisations hors connexion » soient définies pour le compte propriétaire de la licence, et la licence doit d’abord être obtenue une fois en ligne. XStoreRegisterPackageLicenseLost peut être utilisée pour surveiller la perte éventuelle de la licence obtenue à partir de cette API.

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