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.
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 :- XStoreAcquireLicenseForPackageAsync
- XStoreAcquireLicenseForPackageResult
- XStoreIsLicenseValid
- XStoreCloseLicenseHandle
- XStoreRegisterPackageLicenseLost
- XStoreUnregisterPackageLicenseLost
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 SeriesDocumentation conceptuelle
- Opérations de base du Store
- Accorder aux joueurs l’accès au contenu de modules complémentaires
- Activation des tests de licence
Voir aussi
XStoreXStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost
XStoreCanAcquireLicenseForPackageAsync
XStoreCanAcquireLicenseForPackageResult
Gérer le contenu téléchargeable (DLC) et ses licences
