Skip to main content

XStoreAcquireLicenseForPackageAsync

Acquiert une licence pour un package DLC installé (type de produit durable avec un package) du jeu actuel que l’utilisateur a le droit d’utiliser. XStoreRegisterPackageLicenseLost peut être utilisée pour surveiller si la licence obtenue à partir de cette API est perdue.
Cette API ne fonctionne pas avec les modules complémentaires durables sans package.
Pour obtenir la licence d’un durable sans package, utilisez XStoreAcquireLicenseForDurablesAsync.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Le handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. packageIdentifier   _In_z_
Type : char*
Une chaîne qui identifie de manière unique un package du Store. L’identificateur de package est généralement retourné dans le cadre d’une opération XPackageEnumeratePackages. Pour plus d’informations sur les identificateurs de package, consultez Gérer le contenu téléchargeable (DLC) et ses licences. 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

Pour récupérer la licence du package et le résultat de l’exécution de cette fonction, appelez XStoreAcquireLicenseForPackageResult après avoir appelé cette fonction. Si vous souhaitez vérifier si une licence peut être accordée pour un package, appelez XStoreCanAcquireLicenseForPackageAsync. Après avoir acquis une licence, vous devez vérifier si elle est valide en appelant XStoreIsLicenseValid. XPackageMountWithUiAsync acquiert automatiquement une licence lorsqu’elle est appelée. Si aucune licence ne peut être acquise, le montage du package échoue. 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
XStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost
XStoreCanAcquireLicenseForPackageAsync
XStoreCanAcquireLicenseForPackageResult
Gérer le contenu téléchargeable (DLC) et ses licences
Last modified on October 6, 2026