> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XStoreRegisterPackageLicenseLost

> XStoreRegisterPackageLicenseLost

# 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](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync) y [XStoreAcquireLicenseForDurablesAsync](/reference/system/xstore/functions/xstoreacquirelicensefordurablesasync).

## Sintaxis

```cpp theme={null}
HRESULT XStoreRegisterPackageLicenseLost(  
         XStoreLicenseHandle licenseHandle,  
         XTaskQueueHandle queue,  
         void* context,  
         XStorePackageLicenseLostCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  
```

### 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\*](/reference/system/xtaskqueue/structs/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](/reference/system/xstore/functions/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](/reference/system/xstore/functions/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](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync).

## Requisitos

**Encabezado:** XStore.h (incluido en XGameRuntime.h)

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Concesión a los jugadores de acceso a contenido de complementos](/publishing/xstore-commerce/xstore-granting-access)
* [Habilitación de las pruebas de licencias](/publishing/xstore-commerce/xstore-licensing-setup)

## Consulte también

[XStore](/reference/system/xstore/xstore_members)\
[XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync)\
[XStoreAcquireLicenseForPackageResult](/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult)\
[XStoreIsLicenseValid](/reference/system/xstore/functions/xstoreislicensevalid)\
[XStoreCloseLicenseHandle](/reference/system/xstore/functions/xstorecloselicensehandle)\
[XStorePackageLicenseLostCallback](/reference/system/xstore/functions/xstorepackagelicenselostcallback)\
[XStoreUnregisterPackageLicenseLost](/reference/system/xstore/functions/xstoreunregisterpackagelicenselost)\
[Concesión a los jugadores de acceso a contenido de complementos](/publishing/xstore-commerce/xstore-granting-access)


## Related topics

- [XStorePackageLicenseLostCallback](/es/reference/system/xstore/functions/xstorepackagelicenselostcallback.md)
- [XStoreUnregisterPackageLicenseLost](/es/reference/system/xstore/functions/xstoreunregisterpackagelicenselost.md)
- [XStoreAcquireLicenseForPackageResult](/es/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult.md)
- [XStoreIsLicenseValid](/es/reference/system/xstore/functions/xstoreislicensevalid.md)
- [XStoreCloseLicenseHandle](/es/reference/system/xstore/functions/xstorecloselicensehandle.md)