Skip to main content

XStoreAcquireLicenseForPackageAsync

Acquiert une licence pour un package DLC installé (type de produit durable avec package) pour le jeu actuel, que l’utilisateur a le droit d’utiliser. XStoreRegisterPackageLicenseLost peut être utilisée pour surveiller la perte éventuelle de la licence obtenue à partir de cette API.
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
Handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. packageIdentifier   _In_z_
Type : char*
Chaîne qui identifie de façon 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 et accorder des licences pour le contenu téléchargeable (DLC). async   _Inout_
Type : XAsyncBlock*
XAsyncBlock définissant le travail asynchrone en cours. 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 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 obtenue pour un package, appelez XStoreCanAcquireLicenseForPackageAsync. Après avoir acquis une licence, vous devez vérifier qu’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 et accorder des licences pour le contenu téléchargeable (DLC)
Last modified on October 6, 2026