XStoreRegisterPackageLicenseLost
Registra una devolución de llamada para el evento de pérdida de licencia. Use esta API para registrar licencias de duraderos adquiridas mediante XStoreAcquireLicenseForPackageAsync y XStoreAcquireLicenseForDurablesAsync.Sintaxis
Parámetros
licenseHandle _In_Tipo: XStoreLicenseHandle El identificador de licencia para el que se registrará la devolución de llamada. queue _In_
Tipo: XTaskQueueHandle Cola asincrónica para controlar el trabajo asincrónico. context _In_opt_
Tipo: void* Contexto definido por el título que se pasará a la devolución de llamada. callback _In_
Tipo: XStorePackageLicenseLostCallback* La devolución de llamada que se va a registrar. token _Out_
Tipo: XTaskQueueRegistrationToken* Si se ejecuta correctamente, contiene un token que se usa para identificar la devolución de llamada.
Valor devuelto
Tipo: HRESULT Código HRESULT de éxito o de error.Comentarios
Esta función registra la función de devolución de llamada definida por XStorePackageLicenseLostCallback. Se llama a la función de devolución de llamada registrada cuando se produce el siguiente evento de pérdida de licencia de un duradero. No se llama a la función de devolución de llamada durante el registro. Un evento de pérdida de licencia suele producirse cuando la cuenta compradora cierra sesión en el dispositivo y su licencia compartida anteriormente no está disponible para el usuario actual. Para evitar una fuga de memoria, debe llamar a XStoreUnregisterPackageLicenseLost cuando haya terminado con la función de devolución de llamada. Una licencia de duradero se puede perder en cualquier momento debido a un cambio de usuario, un cambio de red, una comprobación de simultaneidad o la expiración de la licencia en el dispositivo. Un juego debe registrarse para los eventos de pérdida de licencia e intentar volver a adquirir la licencia del duradero cuando se desencadene la devolución de llamada. Los eventos de pérdida de licencia pueden ayudar a detectar cuándo el sistema devuelve erróneamente al jugador actual una licencia almacenada en caché que pertenece a otra cuenta. En esos casos, se desencadena inmediatamente un evento de pérdida de licencia y, cuando se vuelve a llamar a XStoreAcquireLicense*, se proporciona una licencia nueva. Para ver un ejemplo de uso, consulte XStoreAcquireLicenseForPackageAsync.Requisitos
Encabezado: XStore.h (incluido en XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesDocumentación conceptual
- Concesión a los jugadores de acceso a contenido de complementos
- Habilitación de las pruebas de licencias
Consulte también
XStoreXStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStorePackageLicenseLostCallback
XStoreUnregisterPackageLicenseLost
Concesión a los jugadores de acceso a contenido de complementos