XStoreRegisterPackageLicenseLost
Inscrit un rappel pour l’événement de perte de licence. Utilisez cette API pour inscrire les licences de contenu durable acquises via XStoreAcquireLicenseForPackageAsync et XStoreAcquireLicenseForDurablesAsync.Syntaxe
Paramètres
licenseHandle _In_Type : XStoreLicenseHandle Handle de licence pour lequel inscrire le rappel. queue _In_
Type : XTaskQueueHandle File d’attente asynchrone chargée du travail asynchrone. context _In_opt_
Type : void* Contexte défini par le titre à transmettre au rappel. callback _In_
Type : XStorePackageLicenseLostCallback* Rappel à inscrire. token _Out_
Type : XTaskQueueRegistrationToken* En cas de réussite, contient un jeton utilisé pour identifier le rappel.
Valeur de retour
Type : HRESULT Code de réussite ou d’erreur HRESULT.Remarques
Cette fonction inscrit la fonction de rappel définie par XStorePackageLicenseLostCallback. La fonction de rappel inscrite est appelée lors du prochain événement de perte d’une licence de contenu durable. La fonction de rappel n’est pas appelée pendant l’inscription. Un événement de perte de licence se produit souvent lorsque le compte acheteur se déconnecte de l’appareil et que sa licence précédemment partagée n’est plus disponible pour l’utilisateur actuel. Pour éviter une fuite de mémoire, vous devez appeler XStoreUnregisterPackageLicenseLost lorsque vous n’avez plus besoin de la fonction de rappel. Une licence de contenu durable peut être perdue à tout moment en raison d’un changement d’utilisateur, d’un changement de réseau, d’une vérification de simultanéité ou de l’expiration de la licence sur l’appareil. Un jeu doit s’inscrire aux événements de perte de licence et tenter de réacquérir la licence du contenu durable lorsque le rappel se déclenche. Les événements de perte de licence peuvent aider à détecter les cas où le système retourne par erreur au joueur actuel une licence mise en cache appartenant à un autre compte. Dans ce cas, un événement de perte de licence se déclenche immédiatement et, lorsque XStoreAcquireLicense* est appelée à nouveau, une nouvelle licence est fournie. Pour un exemple d’utilisation, consultez XStoreAcquireLicenseForPackageAsync.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
Voir aussi
XStoreXStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStorePackageLicenseLostCallback
XStoreUnregisterPackageLicenseLost
Accorder aux joueurs l’accès au contenu des extensions