> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/es/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md) y [XStoreAcquireLicenseForDurablesAsync](https://docs.xbox.com/es/reference/system/xstore/functions/xstoreacquirelicensefordurablesasync.md).

## 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\*](https://docs.xbox.com/es/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)

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](https://docs.xbox.com/es/reference/system/xstore/functions/xstorepackagelicenselostcallback.md).
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](https://docs.xbox.com/es/reference/system/xstore/functions/xstoreunregisterpackagelicenselost.md) 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](https://docs.xbox.com/es/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md).

## 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](https://docs.xbox.com/es/publishing/xstore-commerce/xstore-granting-access.md)
* [Habilitación de las pruebas de licencias](https://docs.xbox.com/es/publishing/xstore-commerce/xstore-licensing-setup.md)

## Consulte también

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


## Related topics

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