Skip to main content

XStoreAcquireLicenseForPackageAsync

Adquiere una licencia para un paquete de DLC instalado (tipo de producto duradero con paquete) del juego actual que el usuario tiene derecho a usar. Se puede usar XStoreRegisterPackageLicenseLost para supervisar si se pierde la licencia obtenida con esta API.
Esta API no funciona con complementos duraderos sin paquete.
Para obtener la licencia de un duradero sin paquete, use XStoreAcquireLicenseForDurablesAsync.

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador de contexto de la tienda para el usuario, devuelto por XStoreCreateContext. packageIdentifier   _In_z_
Tipo: char*
Una cadena que identifica de forma única un paquete de la tienda. El identificador de paquete se devuelve normalmente como parte de una operación de XPackageEnumeratePackages. Para obtener más información sobre los identificadores de paquete, consulte Administración y concesión de licencias de contenido descargable (DLC). async   _Inout_
Tipo: XAsyncBlock*
Un XAsyncBlock que define el trabajo asincrónico que se está realizando. El XAsyncBlock se puede usar para sondear el estado de la llamada y recuperar los resultados de la llamada. Para obtener más información, consulte XAsyncBlock.

Valor devuelto

Tipo: HRESULT HRESULT de éxito o código de error.

Comentarios

Para recuperar la licencia del paquete y el resultado de la ejecución de esta función, llame a XStoreAcquireLicenseForPackageResult después de llamar a esta función. Si desea comprobar si se puede conceder una licencia para un paquete, llame a XStoreCanAcquireLicenseForPackageAsync. Después de adquirir una licencia, debe comprobar si es válida llamando a XStoreIsLicenseValid. XPackageMountWithUiAsync adquiere automáticamente una licencia cuando se le llama. Si no se puede adquirir una licencia, el paquete no se puede montar. Este fragmento de código muestra un ejemplo de uso de las siguientes API:

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

Consulte también

XStore
XStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost
XStoreCanAcquireLicenseForPackageAsync
XStoreCanAcquireLicenseForPackageResult
Administración y concesión de licencias de contenido descargable (DLC)
Última modificación el 28 de agosto de 2026