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.
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 :- 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 des modules complémentaires
- Activation des tests de licence
Voir aussi
XStoreXStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost
XStoreCanAcquireLicenseForPackageAsync
XStoreCanAcquireLicenseForPackageResult
Gérer et accorder des licences pour le contenu téléchargeable (DLC)
